CryptSIPLoad function

The CryptSIPLoad function loads the dynamic-link library (DLL) that implements a subject interface package (SIP) and assigns appropriate library export functions to a SIP_DISPATCH_INFO structure. The exported functions must have been previously registered by calling the CryptSIPAddProvider function.

Syntax

BOOL WINAPI CryptSIPLoad(
  _In_    const GUID              *pgSubject,
  _In_          DWORD             dwFlags,
  _Inout_       SIP_DISPATCH_INFO *pSipDispatch
);

Parameters

pgSubject [in]

A pointer to a GUID returned by calling the CryptSIPRetrieveSubjectGuid function.

dwFlags [in]

This parameter is reserved and must be set to zero.

pSipDispatch [in, out]

A pointer to a SIP_DISPATCH_INFO structure that contains pointers to SIP provider functions that are specific to the subject type. The caller must initialize this structure to binary zeros, and set the cbSize member to sizeof(SIP_DISPATCH_INFO) before calling the CryptSIPLoad function.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE. For extended error information, call GetLastError.

Requirements