IQueryAssociations::Init-Methode (shlwapi.h)

Artikel
08/26/2023

Initialisiert die IQueryAssociations-Schnittstelle und legt den Stammschlüssel auf die entsprechende ProgID fest.

Syntax

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

Parameter

[in] flags

Typ: ASSOCF

Ein Flag, das angibt, wie die Suche initialisiert werden soll. Er wird in der Regel auf 0 festgelegt, kann aber auch einen der folgenden ASSOCF-Werte annehmen.

[in, optional] pszAssoc

Typ: LPCWSTR

Eine Unicode-Zeichenfolge, die zum Bestimmen des Stammschlüssels verwendet wird. Wenn für hkProgid ein Wert angegeben wird, legen Sie diesen Parameter auf NULL fest. Es können vier Zeichenfolgentypen verwendet werden:

Dateinamenerweiterung

Eine Dateinamenerweiterung, z. B. .txt.

CLSID

Eine CLSID-GUID im Standardformat "{GUID}".

ProgID

ProgID einer Anwendung, z. B. Word. Document.8.

Name der ausführbaren Datei

Der Name der .exe-Datei einer Anwendung. Das ASSOCF_OPEN_BYEXENAME-Flag muss in Flags festgelegt werden.

[in, optional] hkProgid

Typ: HKEY

Der HKEY-Wert des Unterschlüssels, der als Stammschlüssel verwendet wird. Die Suche sucht nur unterhalb dieses Schlüssels. Wenn für pwszAssoc ein Wert angegeben wird, legen Sie diesen Parameter auf NULL fest.

[in, optional] hwnd

Typ: HWND

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode initialisiert die -Schnittstelle und wird auch jedes Mal aufgerufen, wenn Sie einen neuen Stammschlüssel angeben müssen. Sie können pwszAssoc verwenden, um eine Zeichenfolge anzugeben, z. B. eine Dateinamenerweiterung oder die zugehörige ProgID, die den Stammschlüssel identifiziert. Sie können auch den HKEY-Wert des Stammschlüssels angeben. Init verwendet dann diese Informationen, um den Stammschlüssel in der Registrierung zu suchen. Nachfolgende Aufrufe der anderen IQueryAssociations-Methoden verwenden sie als Ausgangspunkt und suchen nach den Informationen in den Unterschlüsseln des Stammschlüssels.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IQueryAssociations

Freigeben über