Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 pOutBlobbuffer 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, pOutBlobcan be NULL. If the operation is successful, the minimum buffer size is indicated in pdwOutSize. If pOutBlobis non-NULL ,then pdwOutSizeshould represent the size of the buffer.

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

Requirements

Header cred_prov.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also