UuidFromStringA function (rpcdce.h)

The UuidFromString function converts a string to a UUID.

Syntax

RPC_STATUS UuidFromStringA(
  RPC_CSTR StringUuid,
  UUID     *Uuid
);

Parameters

StringUuid

Pointer to a string representation of a UUID.

Uuid

Returns a pointer to a UUID in binary form.

Return value

Value Meaning
RPC_S_OK
The call succeeded.
RPC_S_INVALID_STRING_UUID
The string UUID is invalid.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

An application calls the UuidFromString function to convert a string UUID to a binary UUID.

Note

The rpcdce.h header defines UuidFromString as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

UuidToString