Edit

WIM_PROVIDER_EXTERNAL_INFO structure (ntifs.h)

  • Article

The WIM_PROVIDER_EXTERNAL_INFO structure holds the identifier and status information for the Windows Image File (WIM) external backing provider.

Syntax

typedef struct _WIM_PROVIDER_EXTERNAL_INFO {
  ULONG         Version;
  ULONG         Flags;
  LARGE_INTEGER DataSourceId;
  UCHAR         ResourceHash[WIM_PROVIDER_HASH_SIZE];
} WIM_PROVIDER_EXTERNAL_INFO, *PWIM_PROVIDER_EXTERNAL_INFO;

Members

Version

The WIM provider version. Set to WIM_PROVIDER_CURRENT_VERSION.

Flags

The status flags for the WIM provider. Set to 0 when active. Otherwise Flags is set to one of the following values.

Value Meaning
WIM_PROVIDER_EXTERNAL_FLAG_NOT_ACTIVE The WIM provider is not active, which can occur when the WIM file is not found. In this case, the WIM file will not be recovered.
WIM_PROVIDER_EXTERNAL_FLAG_SUSPENDED Indicates that the provider is dismounted. Recovery will be attempted.

DataSourceId

An identifier value for the WIM file data source.

ResourceHash[WIM_PROVIDER_HASH_SIZE]

An identifier for the object contained within the WIM. Conventionally a hash of the contents of a file, stored within the WIM.

Remarks

The backing source for a file is set with a FSCTL_SET_EXTERNAL_BACKING control code request. The WIM file backing the file specified in the request is set in the DataSourceId member of WIM_PROVIDER_EXTERNAL_INFO.

The Flags and ResourceHash members are valid when the provider info is returned from a FSCTL_GET_EXTERNAL_BACKING request.

Requirements

Requirement Value
Minimum supported client Windows 8.1 Update
Header ntifs.h (include Ntifs.h, Fltkernel.h)

See also

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING