MsiGetComponentPathExA-Funktion (msi.h)

Die Funktion MsiGetComponentPathEx gibt den vollständigen Pfad einer installierten Komponente zurück. Wenn der Schlüsselpfad für die Komponente ein Registrierungsschlüssel ist, gibt die Funktion den Registrierungsschlüssel zurück.

Diese Funktion erweitert die vorhandene MsiGetComponentPath-Funktion , um die Suche nach Komponenten für Benutzerkonten und Installationskontexte zu ermöglichen.

Syntax

INSTALLSTATE MsiGetComponentPathExA(
  [in]                LPCSTR            szProductCode,
  [in]                LPCSTR            szComponentCode,
  [in, optional]      LPCSTR            szUserSid,
  [in, optional]      MSIINSTALLCONTEXT dwContext,
  [out, optional]     LPSTR             lpOutPathBuffer,
  [in, out, optional] LPDWORD           pcchOutPathBuffer
);

Parameter

[in] szProductCode

Ein null-beendeter Zeichenfolgenwert, der die Produktcode-GUID einer Anwendung angibt. Die Funktion ruft den Pfad der installierten Komponenten ab, die von dieser Anwendung verwendet werden.

[in] szComponentCode

Ein NULL-endender Zeichenfolgenwert, der eine Komponentencode-GUID angibt. Die Funktion ruft den Pfad einer installierten Komponente mit diesem Komponentencode ab.

[in, optional] szUserSid

Ein null-beendeter Zeichenfolgenwert, der die Sicherheits-ID (SID) für einen Benutzer im System angibt. Die Funktion ruft die Pfade der installierten Komponenten von Anwendungen ab, die unter den von dieser SID identifizierten Benutzerkonten installiert sind. Die spezielle SID-Zeichenfolge s-1-1-0 (Jeder) gibt alle Benutzer im System an. Wenn dieser Parameter NULL ist, ruft die Funktion den Pfad einer installierten Komponente nur für den aktuell angemeldeten Benutzer ab.

[in, optional] dwContext

Ein Flag, das den Installationskontext angibt. Die Funktion ruft die Pfade der installierten Komponenten von Anwendungen ab, die im angegebenen Installationskontext installiert sind. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

[out, optional] lpOutPathBuffer

Ein Zeichenfolgenwert, der den Pfad zur Komponente empfängt. Dieser Parameter kann NULL sein. Wenn die Komponente ein Registrierungsschlüssel ist, werden die Registrierungsstämme numerisch dargestellt. Wenn es sich um einen Registrierungsunterschlüsselpfad handelt, befindet sich am Ende des Schlüsselpfads ein umgekehrter Schrägstrich. Wenn es sich um einen Registrierungswertschlüsselpfad handelt, gibt es am Ende keinen umgekehrten Schrägstrich. Beispielsweise wird ein Registrierungspfad auf einem 32-Bit-Betriebssystem von HKEY_CURRENT_USER\SOFTWARE\Microsoft als "01:\SOFTWARE\Microsoft" zurückgegeben. Die unter 32-Bit-Betriebssystemen zurückgegebenen Registrierungsstamme werden wie in der folgenden Tabelle dargestellt definiert.

[in, out, optional] pcchOutPathBuffer

Zeiger auf eine Position, die die Größe des Puffers in TCHAR empfängt, auf die der szPathBuf-Parameter verweist. Der Wert an diesem Speicherort sollte auf die Anzahl von TCHAR in der Zeichenfolge festgelegt werden, einschließlich des beendenden NULL-Zeichens. Wenn die Größe des Puffers zu klein ist, empfängt dieser Parameter die Länge des Zeichenfolgenwerts, ohne das beendende NULL-Zeichen in die Anzahl einzurechnen.

Rückgabewert

Die MsiGetComponentPathEx-Funktion gibt die folgenden Werte zurück.

Hinweise

Die MsiGetComponentPathEx-Funktion kann aus den folgenden Gründen INSTALLSTATE_ABSENT oder INSTALL_STATE_UNKNOWN zurückgeben:

• INSTALLSTATE_ABSENT

  Die Anwendung hat nicht ordnungsgemäß sichergestellt, dass das Feature installiert wurde, indem msiUseFeature und ggf. MsiConfigureFeature aufgerufen wurde.

• INSTALLSTATE_UNKNOWN

  Das Feature wird nicht veröffentlicht. Die Anwendung sollte dies zuvor durch Aufrufen von MsiQueryFeatureState oder MsiEnumFeatures ermittelt haben. Die Anwendung führt diese Aufrufe aus, während sie initialisiert wird. Eine Anwendung sollte nur Features verwenden, von denen bekannt ist, dass sie veröffentlicht werden. Da INSTALLSTATE_UNKNOWN auch von MsiUseFeature zurückgegeben werden sollte, wurde entweder MsiUseFeature nicht aufgerufen, oder sein Rückgabewert wurde nicht ordnungsgemäß überprüft.

Anforderungen

Weitere Informationen

Komponentenspezifische Funktionen