Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Met de functie QueryContextAttributes (CredSSP) kan een transporttoepassing een query uitvoeren op het beveiligingspakket Credential Security Support Provider (CredSSP) voor bepaalde kenmerken van een beveiligingscontext.
Syntaxis
SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
_In_ PCtxtHandle phContext,
_In_ ULONG ulAttribute,
_Out_ PVOID pBuffer
);
Parameterwaarden
-
phContext [in]
-
Een ingang voor de beveiligingscontext die moet worden opgevraagd.
-
ulAttribute [in]
-
Het kenmerk van de context die moet worden geretourneerd. Deze parameter kan een van de volgende waarden zijn. Tenzij anders opgegeven, zijn de kenmerken van toepassing op zowel de client als de server.
Waarde Betekenis - SECPKG_ATTR_C_ACCESS_TOKEN
- 0x80000012
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_AccessToken structuur waarmee het toegangstoken voor de huidige beveiligingscontext wordt opgegeven.
Dit kenmerk wordt alleen ondersteund op de server.- SECPKG_ATTR_C_FULL_ACCESS_TOKEN
- 0x80000082
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_AccessToken structuur waarmee het toegangstoken voor de huidige beveiligingscontext wordt opgegeven.
Dit kenmerk wordt alleen ondersteund op de server.- SECPKG_ATTR_CERT_TRUST_STATUS
- 0x80000084
De parameter pBuffer bevat een aanwijzer naar een CERT_TRUST_STATUS structuur die vertrouwensinformatie over het certificaat opgeeft.
Dit kenmerk wordt alleen ondersteund op de client.- SECPKG_ATTR_CREDS
- 0x80000080
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_ClientCreds structuur waarmee clientreferenties worden opgegeven.
De clientreferenties kunnen een gebruikersnaam en wachtwoord of gebruikersnaam en pincode voor smartcard zijn.
Dit kenmerk wordt alleen ondersteund op de server.- SECPKG_ATTR_CREDS_2
- 0x80000086
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_ClientCreds structuur waarmee clientreferenties worden opgegeven.
Als de clientreferenties gebruikersnaam en wachtwoord zijn, is de buffer een verpakte KERB_INTERACTIVE_LOGON structuur.
Als de clientreferenties gebruikersnaam en pincode voor smartcards zijn, is de buffer een verpakte KERB_CERTIFICATE_LOGON structuur.
Als de clientreferentie een online-identiteitsreferentie is, is de buffer een marshaled SEC_WINNT_AUTH_IDENTITY_EX2 structuur.
Dit kenmerk wordt alleen ondersteund op de CredSSP-server.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 en Windows XP: Deze waarde wordt niet ondersteund.- SECPKG_ATTR_NEGOTIATION_PACKAGE
- 0x80000081
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_PackageInfo structuur waarmee de naam wordt opgegeven van het verificatiepakket dat is onderhandeld door de Microsoft Negotiate-provider . - SECPKG_ATTR_PACKAGE_INFO
- 10
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_PackageInfostructuur.
Retourneert informatie over de SSP die wordt gebruikt.- SECPKG_ATTR_SERVER_AUTH_FLAGS
- 0x80000083
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_Flags structuur die informatie opgeeft over de vlaggen in de huidige beveiligingscontext.
Dit kenmerk wordt alleen ondersteund op de client.- SECPKG_ATTR_SIZES
- 0x0
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_Sizes structuur.
Query's uitvoeren op de grootte van de structuren die worden gebruikt in de functies per bericht en verificatie-uitwisselingen.- SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES
- 124
De parameter pBuffer bevat een aanwijzer naar een SecPkgContext_SubjectAttributes structuur.
Deze waarde retourneert informatie over de beveiligingskenmerken voor de verbinding.
Deze waarde wordt alleen ondersteund op de CredSSP-server.
Windows Server 2008, Windows Vista, Windows Server 2003 en Windows XP: Deze waarde wordt niet ondersteund. -
pBuffer [out]
-
Een aanwijzer naar een structuur die de kenmerken ontvangt. Het structuurtype is afhankelijk van de waarde van de parameter ulAttribute .
Retourwaarde
Als de functie slaagt, wordt SEC_E_OK geretourneerd.
Als de functie mislukt, kunnen de volgende foutcodes worden geretourneerd.
| Retourcode/waarde | Beschrijving |
|---|---|
|
De functie is mislukt. De parameter phContext geeft een ingang op voor een onvolledige context. |
|
De functie is mislukt. De waarde van de parameter ulAttribute is ongeldig. |
Opmerkingen
De structuur die wordt verwezen door de parameter pBuffer , varieert afhankelijk van het kenmerk waarop een query wordt uitgevoerd.
Hoewel de aanroeper de pBuffer-structuur zelf moet toewijzen, wijst de SSP elk geheugen toe dat is vereist voor het opslaan van leden van de pBuffer-structuur met variabele grootte. Geheugen dat door de SSP is toegewezen, moet worden vrijgemaakt door de functie FreeContextBuffer aan te roepen.
Vereisten
| Voorwaarde | Waarde |
|---|---|
| Minimaal ondersteunde client |
Windows Vista [alleen desktop-apps] |
| Minimaal ondersteunde server |
Windows Server 2008 [alleen desktop-apps] |
| Koptekst |
|
| Bibliotheek |
|
| DLL |
|
| Unicode- en ANSI-namen |
QueryContextAttributesW (Unicode) en QueryContextAttributesA (ANSI) |
Zie ook