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 |
---|---|
|
The call succeeded. |
|
The system is out of memory. |
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 |