Função CreateGPOLink (gpedit.h)

A função CreateGPOLink cria um link entre o GPO especificado e o site, domínio ou unidade organizacional especificados.

Sintaxe

GPEDITAPI HRESULT CreateGPOLink(
  [in] LPOLESTR lpGPO,
  [in] LPOLESTR lpContainer,
  [in] BOOL     fHighPriority
);

Parâmetros

[in] lpGPO

Um valor que especifica o caminho para o GPO, no formato ADSI ("LDAP://cn=user, ou=users, dc=coname, dc=com"). Não é possível especificar um nome de servidor neste parâmetro.

[in] lpContainer

Um valor que especifica o caminho do Active Directory para o site, domínio ou unidade organizacional.

[in] fHighPriority

Um valor que especifica a prioridade do link. Se esse parâmetro for TRUE, o sistema criará o link como a prioridade mais alta. Se esse parâmetro for FALSE, o sistema criará o link como a prioridade mais baixa.

Retornar valor

Se a função for bem-sucedida, o valor retornado será S_OK. Caso contrário, a função retornará um dos códigos de erro COM definidos no arquivo de cabeçalho WinError.h. Lembre-se de que você deve testar explicitamente o valor retornado S_OK. Não use a macro SUCCEEDED ou FAILED no HRESULT retornado para determinar o êxito ou a falha da função.

Requisitos

Confira também

DeleteAllGPOLinks

DeleteGPOLink

Funções Política de Grupo

Visão geral da Política de Grupo