HandleBlob

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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 Value

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

See Also

Reference

Credential Manager Type Provider Functions