PrjGetVirtualizationInstanceInfo-Funktion (projectedfslib.h)

Ruft Informationen zur Virtualisierungsinstanz ab.

Syntax

HRESULT PrjGetVirtualizationInstanceInfo(
  [in]  PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [out] PRJ_VIRTUALIZATION_INSTANCE_INFO     *virtualizationInstanceInfo
);

Die Parameter

[in] namespaceVirtualizationContext

Ein undurchsichtiges Handle für die Virtualisierungsinstanz.

[out] virtualizationInstanceInfo

Bei Eingabepunkten auf einen Puffer, der mit Informationen zur Virtualisierungsinstanz gefüllt werden soll. Bei erfolgreicher Rückgabe wird der Puffer ausgefüllt.

Rückgabewert

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

Bemerkungen

ProjFS-Rückrufroutinen stellen das Virtualisierungsinstanzhandle in ihren callbackData-Parametern bereit. Ein Anbieter, der mehrere Virtualisierungsinstanzen verwaltet, kann das InstanceID-Feld von virtualizationInstanceInfo verwenden, um zu ermitteln, welche seiner Virtualisierungsinstanzen den Rückruf empfängt.

Der Anbieter kann das WriteAlignment-Element von virtualizationInstanceInfo verwenden, um die richtigen Werte zu bestimmen, die für die ByteOffset- und Längenparameter von PrjWriteFileData verwendet werden sollen.

Anforderungen