QueryContextAttributes (Negotiate) , funkcja

Funkcja QueryContextAttributes (Negotiate) umożliwia aplikacji transportowej wykonywanie zapytań względem pakietu zabezpieczeń Negotiate dla niektórych atrybutówkontekstu 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]

Określa atrybut kontekstu, który ma zostać zwrócony. Ten parametr może być jedną z następujących wartości.

Wartość	Znaczenie
SECPKG_ATTR_ACCESS_TOKEN 18	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_AccessToken . Zwraca dojście do tokenu dostępu.
SECPKG_ATTR_AUTHORITY 6	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Authority . Wysyła zapytanie do nazwy urzędu uwierzytelniającego.
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET 27	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_ClientSpecifiedTarget , która reprezentuje nazwę główną usługi (SPN) początkowego celu dostarczonego przez klienta. Ta wartość jest obsługiwana tylko w przypadku używania powiązań kanału. Windows Server 2008, Windows Vista, Windows Server 2003 i Windows XP: Ta wartość nie jest obsługiwana.
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_DCE_INFO 3	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_DceInfo . Zapytania dotyczące danych autoryzacji używanych przez usługi DCE.
SECPKG_ATTR_FLAGS 14	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Flags . Zwraca informacje o wynegocjowanych flagach kontekstu.
SECPKG_ATTR_KEY_INFO 5	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_KeyInfo . Wysyła informacje o kluczach używanych w kontekście zabezpieczeń.
SECPKG_ATTR_LAST_CLIENT_TOKEN_STATUS 30	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_LastClientTokenStatus , która określa, czy token z ostatniego wywołania funkcji InitializeSecurityContext jest ostatnim tokenem od klienta. Windows Server 2008, Windows Vista, Windows Server 2003 i Windows XP: Ta wartość nie jest obsługiwana.
SECPKG_ATTR_LIFESPAN 2	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Lifespan . Wykonuje zapytania dotyczące okresu życia kontekstu.
SECPKG_ATTR_LOCAL_CRED	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_LocalCredentialInfo . (przestarzałe) Zastąpione przez SECPKG_ATTR_LOCAL_CERT_CONTEXT.
SECPKG_ATTR_NAMES 1	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Names . Wysyła zapytanie do nazwy skojarzonej z kontekstem.
SECPKG_ATTR_NATIVE_NAMES 13	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_NativeNames . Zwraca nazwę główną (CNAME) z biletu wychodzącego.
SECPKG_ATTR_NEGOTIATION_INFO 12	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_NegotiationInfo . Zwraca informacje o pakiecie zabezpieczeń , który ma być używany z procesem negocjacji i bieżącym stanem negocjacji w celu użycia tego pakietu.
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_PASSWORD_EXPIRY 8	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_PasswordExpiry . Zwraca informacje o wygaśnięciu hasła.
SECPKG_ATTR_ROOT_STORE 0x55	Parametr pBuffer zawiera wskaźnik do HCERTCONTEXT. Znajduje kontekst certyfikatu zawierający certyfikat dostarczony przez magazyn główny.
SECPKG_ATTR_SESSION_KEY 9	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_SessionKey . Zwraca informacje o kluczach sesjis.
SECPKG_ATTR_SIZES 0	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_Sizes . Wykonuje zapytania dotyczące rozmiarów struktur używanych w funkcjach poszczególnych komunikatów.
SECPKG_ATTR_TARGET_INFORMATION 17	Parametr pBuffer zawiera wskaźnik do struktury SecPkgContext_TargetInformation . Zwraca informacje o nazwie serwera zdalnego.

 

pBuffer [out]

Wskaźnik do struktury, która odbiera atrybuty. Typ struktury wskazywany na zależy od wartości określonej w parametrze ulAttribute .

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest SEC_E_OK.

Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest kodem błędu nonzero.

Uwagi

Struktura wskazywana przez parametr pBuffer różni się w zależności od badanego atrybutu. Obiekt wywołujący musi przydzielić samą strukturę pBuffer , ale dostawca usług udostępnionych przydziela dowolną pamięć wymaganą do przechowywania składowych o zmiennym rozmiarze struktury pBuffer . Pamięć przydzielona przez dostawcę usług udostępnionych może zostać zwolniona przez wywołanie funkcji FreeContextBuffer .

Po odczytaniu wartości SECPKG_ATTR_REMOTE_CERT_CONTEXT lub SECPKG_ATTR_LOCAL_CERT_CONTEXT element członkowski hCertStore zostanie ustawiony na dojście do magazynu certyfikatów zawierającego certyfikaty pośrednie, jeśli istnieje. Ponadto aplikacja jest odpowiedzialna za wywołanie elementu CertFreeCertificateContext w celu zwolnienia pamięci używanej przez kontekst certyfikatu.

Wymagania

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows XP [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows Server 2003 [tylko aplikacje klasyczne]
Nagłówek	Sspi.h (include Security.h)
Biblioteka	Secur32.lib
DLL	Secur32.dll
Nazwy Unicode i ANSI	QueryContextAttributesW (Unicode) i QueryContextAttributesA (ANSI)

Zobacz też

funkcji SSPI

CERT_CONTEXT

FreeContextBuffer

SecPkgContext_Authority

SecPkgContext_ConnectionInfo

SecPkgContext_DceInfo

SecPkgContext_IssuerListInfoEx

SecPkgContext_KeyInfo

SecPkgContext_Lifespan

SecPkgContext_Names

SecPkgContext_Sizes

SecPkgContext_StreamSizes