uuidToStringA 函数 (rpcdce.h)

UuidToString 函数将 UUID 转换为字符串。

语法

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

[in] Uuid

指向二进制 UUID 的指针。

[out] StringUuid

指向以 null 结尾的字符串的指针， Uuid 参数中指定的 UUID 将放置到该字符串中。

值	含义
RPC_S_OK	调用成功。
RPC_S_OUT_OF_MEMORY	系统内存不足。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

应用程序调用 UuidToString 将二进制 UUID 转换为字符串 UUID。 RPC 运行时库为 StringUuid 参数中返回的字符串分配内存。应用程序负责调用 RpcStringFree 以解除分配该内存。

注意

rpcdce.h 标头将 UuidToString 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。