Compartilhar via


Função CoCreateGuid (combaseapi.h)

Cria um GUID, um inteiro exclusivo de 128 bits usado para CLSIDs e identificadores de interface.

Sintaxe

HRESULT CoCreateGuid(
  [out] GUID *pguid
);

Parâmetros

[out] pguid

Um ponteiro para o GUID solicitado.

Retornar valor

Código de retorno Descrição
S_OK
O GUID foi criado com êxito.
 

Os erros retornados por UuidCreate são encapsulados como UM HRESULT.

Comentários

A função CoCreateGuid chama a função RPC UuidCreate, que cria um GUID, um inteiro de 128 bits globalmente exclusivo. Use CoCreateGuid quando precisar de um número absolutamente exclusivo que você usará como um identificador persistente em um ambiente distribuído. Para um grau muito alto de certeza, essa função retorna um valor exclusivo – nenhuma outra invocação, no mesmo ou em qualquer outro sistema (rede ou não), deve retornar o mesmo valor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

UuidCreate