Função UuidToStringA (rpcdce.h)

Artigo
11/20/2024

A função UuidToString converte um UUID em uma cadeia de caracteres.

Sintaxe

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

Parâmetros

[in] Uuid

Ponteiro para umUUID de binário.

[out] StringUuid

Ponteiro para a cadeia de caracteres terminada em nulo na qual o UUID especificado no parâmetro Uuid será colocado.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_OUT_OF_MEMORY	O sistema está sem memória.

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Observações

Um aplicativo chama UuidToString para converter um UUID de binário em uma cadeia de caracteres UUID. A biblioteca de tempo de execução RPC aloca memória para a cadeia de caracteres retornada no parâmetro stringUuid . O aplicativo é responsável por chamar RpcStringFree para desalocar essa memória.

Nota

O cabeçalho rpcdce.h define UuidToString como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcStringFree

UuidFromString

Compartilhar via