HandleBlob (Windows CE 5.0)

Send Feedback

This function enables type providers to determine what information has to be cached by credential manager.

DWORD HandleBlob(  DWORD dwType,  PWCHAR szTarget,  PWCHAR szUser,  PBYTE pInBlob,  DWORD dwInSize,  PBYTE pOutBlob,  PDWORD pdwOutSize,  DWORD dwFlag);

Parameters

  • dwType
    [in] Type for which the entry point is being called.

  • szTarget
    [in] Target of blob.

  • szUser
    [in] User associated with blob.

  • pInBlob
    [in] Input blob.

  • dwInSize
    Input blob size in bytes.

  • pOutBlob
    [in, out] Pointer to buffer where provider blob can be stored.

  • pdwOutSize
    [in, out] On input, contains the size of pOutBlob buffer in bytes.

    On output, contains the amount of buffer used.

  • dwFlag
    Reserved, set to zero.

Return Values

ERROR_SUCCESS is returned upon success. For a list of error codes, see Credential Manager Error Codes.

Remarks

The information to be cached by the credential manager may be different from the information provided by the user. For example, in the case of NTLM, only the hash of the password is stored, even though the user provides a password. This also gives the type provider the opportunity not to cache any credential information. If the type provider does not support this entry point, then whatever information the user provides is cached by credential manager.

If the caller wants to calculate how much memory to allocate, pOutBlob can be NULL. If the operation is successful, the minimum buffer size is indicated in pdwOutSize. If pOutBlob is non-NULL ,then pdwOutSize should represent the size of the buffer.

If the buffer size is insufficient, then ERROR_MORE_DATA is returned.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Cred_prov.h.
Link Library: Coredll.lib.

See Also

Credential Manager Type Provider Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.