Edit

Share via

UuidToString function (rpcdce.h)

  • Article

The UuidToString function converts a UUID to a string.

Syntax

RPC_STATUS UuidToString(
  [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.

The UUID format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

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

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