UuidToString

The UuidToString function converts a UUID to a string.

#include <rpc.h>
RPC_STATUS RPC_ENTRY UuidToString( 
  UUID *  Uuid,                  
  unsigned char * *  StringUuid  
);

Parameters

Uuid
Points to a binary UUID.
StringUuid
Returns a pointer to a pointer to the string representation of the UUID specified in the Uuid argument.

Specify a null value to prevent UuidToString from returning the StringUuid argument. In this case, the application does not call the RpcStringFree routine.

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 argument. The application is responsible for calling the RpcStringFree routine to deallocate that memory.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_OUT_OF_MEMORY No memory

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcStringFree, UuidFromString