Expand Minimize

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH function pointer

The PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH callback function specifies that an object has changed. The provider calls this function when the provider has determined that a particular name or identifier has been updated.

Syntax


typedef BOOL ( WINAPI *PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH)(
  _In_  LPVOID pContext,
  _In_  PCERT_NAME_BLOB *rgIdentifierOrNameList,
  _In_  DWORD dwIdentifierOrNameListCount
);

Parameters

pContext [in]

Pointer to a provider defined object that contains information about this provider.

rgIdentifierOrNameList [in]

Pointer to an array of names or identifiers.

dwIdentifierOrNameListCount [in]

The number of names or identifiers specified by the rgIdentifierOrNameList parameter.

Return value

If the function succeeds, return nonzero (TRUE).

If the function fails, return zero (FALSE).

Remarks

A provider calls an implementation of the PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH callback function to indicate that an object has changed.

A pointer to this function is set in the pfnFlush parameter of the PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE function.

An identifier is data chosen by the provider to represent the object being located for the caller. Identifiers need not be unique. If the provider determines that the object associated with the identifier is no longer valid, it should call this function to mark all objects with the associated identifier as invalid. This function is thread safe.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Wincrypt.h

See also

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft