Функция UuidToStringA (rpcdce.h)

Статья
11/20/2024

Функция 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows 2000 Server [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	rpcdce.h (include Rpc.h)
библиотеки	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также

RpcStringFree

UuidFromString

Поделиться через