QueryContextAttributes (CredSSP) — funkcja

Funkcja QueryContextAttributes (CredSSP) umożliwia aplikacji transportowej wykonywanie zapytań względem pakietu zabezpieczeń dostawcy zabezpieczeń poświadczeń (CredSSP) dla niektórych atrybutów kontekstu zabezpieczeń.

Składnia

SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

Parametry

phContext [in]

Dojście do kontekstu zabezpieczeń do odpytowania.

ulAttribute [in]

Atrybut kontekstu, który ma zostać zwrócony. Ten parametr może być jedną z następujących wartości. Jeśli nie określono inaczej, atrybuty mają zastosowanie zarówno do klienta, jak i serwera.

Wartość	Znaczenie
SECPKG_ATTR_C_ACCESS_TOKEN 0x80000012	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_AccessToken , która określa token dostępu dla bieżącego kontekstu zabezpieczeń. Ten atrybut jest obsługiwany tylko na serwerze.
SECPKG_ATTR_C_FULL_ACCESS_TOKEN 0x80000082	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_AccessToken , która określa token dostępu dla bieżącego kontekstu zabezpieczeń. Ten atrybut jest obsługiwany tylko na serwerze.
SECPKG_ATTR_CERT_TRUST_STATUS 0x80000084	Parametr pBuffer zawiera wskaźnik do struktury CERT_TRUST_STATUS , która określa informacje o zaufaniu certyfikatu. Ten atrybut jest obsługiwany tylko na kliencie.
SECPKG_ATTR_CREDS 0x80000080	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_ClientCreds , która określa poświadczenia klienta. Poświadczenia klienta mogą być nazwą użytkownika i hasłem lub nazwą użytkownika oraz numerem PIN karty inteligentnej. Ten atrybut jest obsługiwany tylko na serwerze.
SECPKG_ATTR_CREDS_2 0x80000086	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_ClientCreds , która określa poświadczenia klienta. Jeśli poświadczenie klienta to nazwa użytkownika i hasło, bufor jest spakowanym KERB_INTERACTIVE_LOGON strukturą. Jeśli poświadczenie klienta to nazwa użytkownika i numer PIN karty inteligentnej, bufor jest zapakowaną strukturą KERB_CERTIFICATE_LOGON . Jeśli poświadczenie klienta jest poświadczenie tożsamości online, bufor jest strukturą SEC_WINNT_AUTH_IDENTITY_EX2 marshaled. Ten atrybut jest obsługiwany tylko na serwerze CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 i Windows XP: Ta wartość nie jest obsługiwana.
SECPKG_ATTR_NEGOTIATION_PACKAGE 0x80000081	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_PackageInfo , która określa nazwę pakietu uwierzytelniania wynegocjowanego przez dostawcę Microsoft Negotiate .
SECPKG_ATTR_PACKAGE_INFO 10	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_PackageInfo. Zwraca informacje dotyczące dostawcy usług udostępnionych w użyciu.
SECPKG_ATTR_SERVER_AUTH_FLAGS 0x80000083	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Flags , która określa informacje o flagach w bieżącym kontekście zabezpieczeń. Ten atrybut jest obsługiwany tylko na kliencie.
SECPKG_ATTR_SIZES 0x0	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Sizes . Wykonuje zapytania dotyczące rozmiarów struktur używanych w funkcjach poszczególnych komunikatów i wymianach uwierzytelniania.
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES 124	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_SubjectAttributes . Ta wartość zwraca informacje o atrybutach zabezpieczeń dla połączenia. Ta wartość jest obsługiwana tylko na serwerze CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 i Windows XP: Ta wartość nie jest obsługiwana.

 

pBuffer [out]

Wskaźnik do struktury, która odbiera atrybuty. Typ struktury zależy od wartości parametru ulAttribute .

Wartość zwracana

Jeśli funkcja powiedzie się, zwraca SEC_E_OK.

Jeśli funkcja zakończy się niepowodzeniem, może zwrócić następujące kody błędów.

Uwagi

Struktura wskazywana przez parametr pBuffer różni się w zależności od badanego atrybutu.

Mimo że obiekt wywołujący musi przydzielić samą strukturę pBuffer , dostawcy usług udostępnionych przydzielają dowolną pamięć wymaganą do przechowywania składowych o zmiennym rozmiarze struktury pBuffer . Pamięć przydzielona przez dostawcę usług udostępnionych musi zostać zwolniona przez wywołanie funkcji FreeContextBuffer .

Wymagania

Zobacz też

funkcji SSPI

CERT_CONTEXT

FreeContextBuffer

SecPkgContext_ClientCreds

SecPkgContext_Sizes