Condividi tramite


Funzione CreateGPOLink (gpedit.h)

La funzione CreateGPOLink crea un collegamento tra l'oggetto Criteri di gruppo specificato e il sito, il dominio o l'unità organizzativa specificati.

Sintassi

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

Parametri

[in] lpGPO

Valore che specifica il percorso dell'oggetto Criteri di gruppo in formato ADSI ("LDAP://cn=user, ou=users, dc=coname, dc=com"). Non è possibile specificare un nome del server in questo parametro.

[in] lpContainer

Valore che specifica il percorso di Active Directory per il sito, il dominio o l'unità organizzativa.

[in] fHighPriority

Valore che specifica la priorità del collegamento. Se questo parametro è TRUE, il sistema crea il collegamento come priorità più alta. Se questo parametro è FALSE, il sistema crea il collegamento come priorità più bassa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, la funzione restituisce uno dei codici di errore COM definiti nel file di intestazione WinError.h. Tenere presente che è necessario testare in modo esplicito il valore restituito S_OK. Non usare la macro SUCCEEDED o FAILED nell'HRESULT restituito per determinare l'esito positivo o negativo della funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione gpedit.h
Libreria GPEdit.lib
DLL GPEdit.dll

Vedi anche

DeleteAllGPOLinks

DeleteGPOLink

Funzioni Criteri di gruppo

Panoramica di Criteri di gruppo