IQueryAssociations::Init-Methode (shlwapi.h)

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
);

Die Parameter

[in] flags

Typ: ASSOCF

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

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[in, optional] pszAssoc

Typ: LPCWSTR

Eine Unicode-Zeichenfolge, die verwendet wird, um den Stammschlüssel zu bestimmen. Wenn für hkProgid ein Wert angegeben ist, legen Sie diesen Parameter auf NULL fest. Vier Zeichenfolgentypen können 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 sieht nur unter diesem Schlüssel aus. Wenn für pwszAssoc ein Wert angegeben ist, legen Sie diesen Parameter auf NULL fest.

[in, optional] hwnd

Typ: HWND-

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

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 finden. Nachfolgende Aufrufe der anderen IQueryAssociations-Methoden verwenden sie als Ausgangspunkt und suchen nach den Informationen in den Unterschlüsseln des Stammschlüssels.

Anforderungen

Siehe auch

IQueryAssociations