CryptGetDefaultOIDFunctionAddress

  • Article

This function loads the DLL containing a default function address. It can also be used to return the address of first or next installed default OID function in an initialized function set and load the DLL containing that function address.

BOOL WINAPI CryptGetDefaultOIDFunctionAddress(
  HCRYPTOIDFUNCSET hFuncSet,
  DWORD dwEncodingType,
  LPCWSTR pwszDll,
  DWORD dwFlags,
  void** ppvFuncAddr,
  HCRYPTOIDFUNCADDR* phFuncAddr
);

Parameters

  • hFuncSet
    [in] Handle previously obtained from a call to the CryptInitOIDFunctionSet function.

  • dwEncodingType
    [in] Specifies the encoding type to be matched. Currently, only X509_ASN_ENCODING is used; however, additional encoding types may be added in the future.

  • pwszDll
    [in] Optional. Set to NULL.

  • dwFlags
    [in] Reserved for future use and must be set to zero.

  • ppvFuncAddr
    [out] Pointer to the return function's address. If the function fails, a NULL is returned in the ppvFuncAddr parameter.

  • phFuncAddr
    [in, out] On the first call to the function, this parameter must be NULL to acquire the first installed function.

    When this function is successful, this parameter is set to a function handle. The function's handle reference count is incremented.

    After the first call to the function, this parameter is set to the pointer returned by the previous call. This input pointer is always freed within the function through a call to the CryptFreeOIDFunctionAddress function by this function. The call to free the pointer is always made even if the main function returns an error

    A non-NULL phFuncAddr parameter must be released either through a call to the CryptFreeOIDFunctionAddress function or by being passed back as input to this function or as input to the CryptGetOIDFunctionAddress function.

Return Values

If the function succeeds, the return value is nonzero, or TRUE.

If the function fails, the return value is zero, or FALSE.

Remarks

The desktop platform supports the flag PKCS_7_ASN_ENCODING, but Windows CE does not and ignores the flag when it is specified.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Wincrypt.h.
Link Library: Crypt32.lib.

See Also

CryptEnumOIDInfo | CryptFindOIDInfo | CryptFreeOIDFunctionAddress | CryptGetOIDFunctionAddress | CryptInitOIDFunctionSet

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.