MsiGetSourcePathA-Funktion (msiquery.h)

Die MsiGetSourcePath-Funktion gibt den vollständigen Quellpfad für einen Ordner in der Verzeichnistabelle zurück.

Syntax

UINT MsiGetSourcePathA(
  [in]      MSIHANDLE hInstall,
  [in]      LPCSTR    szFolder,
  [out]     LPSTR     szPathBuf,
  [in, out] LPDWORD   pcchPathBuf
);

Parameter

[in] hInstall

Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[in] szFolder

Eine Zeichenfolge mit NULL-Beendigung, die einen Datensatz der Directory-Tabelle angibt. Wenn das Verzeichnis ein Stammverzeichnis ist, kann dies ein Wert aus der Spalte DefaultDir sein. Andernfalls muss es sich um einen Wert aus der Spalte Verzeichnis handeln.

[out] szPathBuf

Zeiger auf den Puffer, der den mit NULL beendeten vollständigen Quellpfad empfängt. Versuchen Sie nicht, die Größe des Puffers zu bestimmen, indem Sie null (value=0) für szPathBuf übergeben. Sie können die Größe des Puffers abrufen, indem Sie eine leere Zeichenfolge übergeben (z. B. ""). Die Funktion gibt dann ERROR_MORE_DATA zurück, und pcchPathBuf enthält die erforderliche Puffergröße in TCHARs, ohne das abschließende NULL-Zeichen. Bei Rückgabe von ERROR_SUCCESS enthält pcchPathBuf die Anzahl der TCHARs, die in den Puffer geschrieben wurden, ohne das abschließende NULL-Zeichen.

[in, out] pcchPathBuf

Zeiger auf die Variable, die in TCHARs die Größe des Puffers angibt, auf den die Variable szPathBuf verweist. Wenn die Funktion ERROR_SUCCESS zurückgibt, enthält diese Variable die Größe der daten, die in szPathBuf kopiert wurden, ohne das abschließende NULL-Zeichen. Wenn szPathBuf nicht groß genug ist, gibt die Funktion ERROR_MORE_DATA zurück und speichert die erforderliche Größe (ohne das abschließende NULL-Zeichen) in der Variablen, auf die von pcchPathBuf verwiesen wird.

Rückgabewert

Die MsiGetSourcePath-Funktion gibt die folgenden Werte zurück:

Hinweise

Vor dem Aufrufen dieser Funktion muss das Installationsprogramm zuerst die Aktionen CostInitialize, FileCost und CostFinalize ausführen. Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

Wenn ERROR_MORE_DATA zurückgegeben wird, gibt der Parameter, bei dem es sich um einen Zeiger handelt, die Größe des Puffers an, der zum Halten der Zeichenfolge erforderlich ist. Wenn ERROR_SUCCESS zurückgegeben wird, wird die Anzahl der In den Zeichenfolgenpuffer geschriebenen Zeichen angegeben. Daher können Sie die Größe des Puffers abrufen, indem Sie eine leere Zeichenfolge (z. B. "") für den Parameter übergeben, der den Puffer angibt. Versuchen Sie nicht, die Größe des Puffers zu bestimmen, indem Sie einen Nullwert (wert=0) übergeben.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

Anforderungen

Weitere Informationen

Installerspeicherortfunktionen

Übergeben von NULL als Argument von Windows Installer Functions