Función PrjWritePlaceholderInfo (projectedfslib.h)

Envía metadatos de archivo o directorio a ProjFS.

Sintaxis

HRESULT PrjWritePlaceholderInfo(
  [in] PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in] PCWSTR                               destinationFileName,
  [in] const PRJ_PLACEHOLDER_INFO           *placeholderInfo,
  [in] UINT32                               placeholderInfoSize
);

Parámetros

[in] namespaceVirtualizationContext

Identificador opaco para la instancia de virtualización. Debe ser el valor del miembro VirtualizationInstanceHandle del callbackData pasado al proveedor en el PRJ_GET_PLACEHOLDER_INFO_CB devolución de llamada.

[in] destinationFileName

Cadena Unicode terminada en null que especifica la ruta de acceso, relativa a la raíz de virtualización, al archivo o directorio para el que se va a crear un marcador de posición.

Debe ser una coincidencia con el miembro FilePathName del parámetro callbackData pasado al proveedor en la devolución de llamada PRJ_GET_PLACEHOLDER_INFO_CB . El proveedor debe usar la función PrjFileNameCompare para determinar si los dos nombres coinciden.

Por ejemplo, si el PRJ_GET_PLACEHOLDER_INFO_CB devolución de llamada especifica "dir1\dir1\FILE.TXT" en callbackData-FilePathName> y el almacén de respaldo del proveedor contiene un archivo denominado "File.txt" en el directorio dir1\dir2 y PrjFileNameCompare devuelve 0 al comparar los nombres "FILE.TXT" y "File.txt", el proveedor especifica "dir1\dir2\File.txt" como valor de este parámetro.

[in] placeholderInfo

Puntero a los metadatos del archivo o directorio.

[in] placeholderInfoSize

Tamaño en bytes del búfer al que apunta placeholderInfo.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El proveedor usa esta rutina para proporcionar los datos solicitados en una invocación de su PRJ_GET_PLACEHOLDER_INFO_CB devolución de llamada, o puede usarlo para establecer proactivamente un marcador de posición.

Los miembros EaInformation, SecurityInformation y StreamsInformation de PRJ_PLACEHOLDER_INFO son opcionales. Si el proveedor no desea proporcionar atributos extendidos, descriptores de seguridad personalizados o flujos de datos alternativos, debe establecer estos campos en 0.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	projectedfslib.h