ICEnroll4::stringToBinary method (xenroll.h)

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The stringToBinary method converts an encoded string to a binary data BLOB. This method was first defined in the ICEnroll4 interface.

The stringToBinary method calls the CryptStringToBinary function.

Syntax

HRESULT stringToBinary(
  [in]  LONG Flags,
  [in]  BSTR strEncoded,
  [out] BSTR *pstrBinary
);

Parameters

[in] Flags

A value passed to the dwFlags parameter of the CryptStringToBinary function. For valid values, see CryptStringToBinary.

[in] strEncoded

An encoded string to be converted to a binary data BLOB.

[out] pstrBinary

A pointer to a BSTR that receives the binary data. When you have finished using the BSTR, free it by calling the SysFreeString function.

Return value

C++

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

The return value is a string that contains the binary data.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header xenroll.h
Library Uuid.lib
DLL Xenroll.dll