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] Function set handle previously obtained from a call to the CryptInitOIDFunctionSet.

  • dwEncodingType
    [in] 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 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, *phFuncAddr must be NULL to acquire the first installed function.

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

    After the first call to the function, the phFuncAddr 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 (TRUE).

If the function fails, the return value is zero (FALSE).

Remarks

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 or later Wincrypt.h   Crypt32.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CryptEnumOIDInfo, CryptFindOIDInfo, CryptFreeOIDFunctionAddress, CryptGetOIDFunctionAddress, CryptInitOIDFunctionSet

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.