IResolveShellLink::ResolveShellLink-Methode (shobjidl_core.h)

Artikel
08/26/2023

Fordert an, dass ein Ordnerobjekt einen Shelllink auflöst.

Syntax

HRESULT ResolveShellLink(
  [in] IUnknown *punkLink,
  [in] HWND     hwnd,
  [in] DWORD    fFlags
);

Parameter

[in] punkLink

Typ: IUnknown*

Zeiger auf die IShellLink-Schnittstelle des Objekts. Diese Schnittstelle kann dann abgefragt werden, um den Inhalt des Links zu bestimmen.

[in] hwnd

Typ: HWND

Handle für das Fenster, das die Shell als übergeordnetes Element für ein Dialogfeld verwendet. Die Shell zeigt das Dialogfeld an, wenn sie den Benutzer beim Auflösen des Links zur Eingabe weiterer Informationen auffordern muss.

[in] fFlags

Art: DWORD

Aktionsflags. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

SLR_INVOKE_MSI

Rufen Sie den Windows Installer auf.

SLR_NOLINKINFO

Deaktivieren sie die Nachverfolgung verteilter Links. Standardmäßig verfolgt die Nachverfolgung von verteilten Links Wechselmedien auf mehreren Geräten basierend auf dem Volumenamen nach. Außerdem wird der UNC-Pfad verwendet, um Remotedateisysteme nachzuverfolgen, deren Laufwerkbuchstabe sich geändert hat. Durch festlegen SLR_NOLINKINFO werden beide Arten der Nachverfolgung deaktiviert.

SLR_NO_UI

Kein Dialogfeld anzeigen, wenn der Link nicht aufgelöst werden kann. Wenn SLR_NO_UI festgelegt ist, gibt das Wort mit hoher Ordnung von fFlags eine Timeoutdauer in Millisekunden an. Die Funktion gibt zurück, wenn der Link nicht innerhalb der Timeoutdauer aufgelöst werden kann. Wenn das Wort mit hoher Reihenfolge auf 0 (null) festgelegt ist, beträgt die Timeoutdauer standardmäßig 3.000 Millisekunden (3 Sekunden).

SLR_NOUPDATE

Aktualisieren Sie die Linkinformationen nicht.

SLR_NOSEARCH

Führen Sie die Suchheuristik nicht aus.

SLR_NOTRACK

Verwenden Sie keine Nachverfolgung verteilter Links.

SLR_UPDATE

Wenn sich das Linkobjekt geändert hat, aktualisieren Sie den Pfad und die Liste der Bezeichner. Wenn SLR_UPDATE festgelegt ist, müssen Sie IPersistFile::IsDirty nicht aufrufen, um festzustellen, ob sich das Linkobjekt geändert hat.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode sollte versuchen, das Ziel eines Shelllinks zu finden, auch wenn das Ziel verschoben oder umbenannt wurde.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IResolveShellLink

Share via