UuidToStringA function (rpcdce.h)

The UuidToString function converts a UUID to a string.

Syntax

RPC_STATUS UuidToStringA(
  [in]  const UUID *Uuid,
  [out] RPC_CSTR   *StringUuid
);

Parameters

[in] Uuid

Pointer to a binary UUID.

[out] StringUuid

Pointer to the null-terminated string into which the UUID specified in the Uuid parameter will be placed.

Return value

Value Meaning
RPC_S_OK
The call succeeded.
RPC_S_OUT_OF_MEMORY
The system is out of memory.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

An application calls UuidToString to convert a binary UUID to a string UUID. The RPC run-time library allocates memory for the string returned in the StringUuid parameter. The application is responsible for calling RpcStringFree to deallocate that memory.

Note

The rpcdce.h header defines UuidToString 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

RpcStringFree

UuidFromString