QueryCredentialsAttributes (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.