QueryCredentialsAttributes (Windows CE 5.0)
This function retrieves the attributes of a credential, such as the name associated with the credential.
SECURITY_STATUS SEC_ENTRY QueryCredentialsAttributes( PCredHandle phCredential,ULONG ulAttribute,void SEC_FAR* pBuffer );
Parameters
- phCredential
[in] Pointer to a CredHandle structure containing the handle to the credentials to query. For information on CredHandle, see SSPI Handles. - ulAttribute
[in] The attribute to query. This parameter must be SECPKG_CRED_ATTR_NAMES. - pBuffer
[out] Pointer to a buffer containing the requested attribute. For the SECPKG_CRED_ATTR_NAMES attribute, pBuffer must indicate a SecPkgCredentials_Names structure.
Return Values
Returns SEC_E_OK to indicate success. The following table shows the possible error values.
| Value | Description |
|---|---|
| SEC_E_INVALID_HANDLE | The handle passed to the function is invalid. |
| SEC_E_INSUFFICIENT_MEMORY | Insufficient memory. |
Remarks
This function allows a customer of the security services to determine the name associated with the specified credentials.
The caller must allocate the structure pointed to by the pBuffer parameter. The security provider allocates the buffer for any pointer retrieved in the pBuffer structure. The caller can call the FreeContextBuffer function to free any pointers allocated by the security provider.
Requirements
Pocket PC: Pocket PC 2000 and later.
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 2.10 and later.
Header: Security.h, Sspi.h.
Link Library: Secur32.lib.
See Also
FreeContextBuffer | SecPkgCredentials_Names
Send Feedback on this topic to the authors