UuidToString function

The UuidToString function converts a UUID to a string.

Syntax


RPC_STATUS RPC_ENTRY UuidToString(
  _In_  const UUID __RPC_FAR      *Uuid ,
  _Out_       RPC_CSTR  __RPC_FAR *StringUuid
);

Parameters

Uuid [in]: Pointer to a binary UUID.
StringUuid [out]: 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.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll
Unicode and ANSI names	UuidToStringW (Unicode) and UuidToStringA (ANSI)