Freigeben über


IGPEInformation::GetHint-Methode (gpedit.h)

Die GetHint-Methode ruft den Typ des Active Directory-Objekts ab, mit dem dieses Gruppenrichtlinienobjekt verknüpft werden kann.

Syntax

HRESULT GetHint(
  [out] GROUP_POLICY_HINT_TYPE *gpHint
);

Parameter

[out] gpHint

Empfängt den Verzeichnisdiensttyp. Dieser Parameter kann einen der folgenden Werte annehmen.

GPHintUnknown

Es sind keine Linkinformationen verfügbar.

GPHintMachine

Das Objekt kann mit einem Computer (lokal oder remote) verknüpft werden.

GPHintSite

Das Objekt kann mit einer Website verknüpft werden.

GPHintDomain

Das Objekt kann mit einer Domäne verknüpft werden.

GPHintOrganizationalUnit

Das Objekt kann mit einer Organisationseinheit verknüpft werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind.

Hinweise

Der Gruppenrichtlinie-Objekt-Editor kann nicht ermitteln, welche Active Directory-Objekte mit einem bestimmten Gruppenrichtlinienobjekt verknüpft sind. Die GetHint-Methode stellt Verknüpfungsinformationen bereit, die darauf basieren, wie der Benutzer den Gruppenrichtlinie-Objekt-Editor gestartet hat. Es kann auf folgende Weise gestartet werden:

  • Als Erweiterung des Active Directory-Managers. Navigieren Sie zur Website, Domäne oder Organisationseinheit, und wählen Sie dann Gruppenrichtlinie aus.
  • Als eigenständiges MMC-Tool mit einem bestimmten Link.
  • Als eigenständiges MMC-Tool ohne spezifische Verknüpfung.
Möglicherweise möchten Sie die Benutzeroberfläche Ihrer Anwendung basierend auf dem Ergebnis des Aufrufs dieser Methode anpassen. Verwenden Sie diese Methode jedoch mit Vorsicht, da der zurückgegebene Wert den falschen Bereich angeben kann.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile gpedit.h
DLL Gpedit.dll

Weitere Informationen

Gruppenrichtlinie Schnittstellen

Übersicht über Gruppenrichtlinien

IGPEInformation