Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
| Zwracanie kodu/wartości | Opis |
|---|---|
|
Funkcja nie powiodła się. Parametr phContext określa dojście do niekompletnego kontekstu. |
|
Funkcja nie powiodła się. Wartość parametru ulAttribute jest nieprawidłowa. |
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
| Wymaganie | Wartość |
|---|---|
| Minimalny obsługiwany klient |
Windows Vista [tylko aplikacje klasyczne] |
| Minimalny obsługiwany serwer |
Windows Server 2008 [tylko aplikacje klasyczne] |
| Nagłówek |
|
| Biblioteka |
|
| DLL |
|
| Nazwy Unicode i ANSI |
QueryContextAttributesW (Unicode) i QueryContextAttributesA (ANSI) |
Zobacz też