структура NETWORK_APP_INSTANCE_EA (ntifs.h)

Структура расширенного атрибута (EA) для процессов с помощью отработки отказа клиента кластера SMB.

Синтаксис

typedef struct _NETWORK_APP_INSTANCE_EA {
  GUID  AppInstanceID;
  ULONG CsvFlags;
} NETWORK_APP_INSTANCE_EA, *PNETWORK_APP_INSTANCE_EA;

Члены

AppInstanceID

GUID, определяющий один экземпляр приложения или структуру NETWORK_APP_INSTANCE_EA, если приложение дополнительно содержит флаг для CSVFlags.

CsvFlags

Необязательный флаг: NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR (0x00000001)

Флаг NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR используется только при открытии файла непосредственно из CSVFS. Этот флаг игнорируется при открытии файла с помощью протокола SMB. Флаг уведомляет CSVFS о том, что файл будет открыт только на скоординированном узле. Если запрос open отправляется в CSVFS, а узел не координируется, открытие завершится ошибкой. Кроме того, если при открытии файла перемещается координирующий узел, открытие файла будет недействительным.

Замечания

Процесс может зарегистрировать идентификатор приложения CCF с помощью RegisterAppInstance, что позволяет всем операциям open из процесса иметь один и тот же Идентификатор ApplicationId. Если идентификатор не зарегистрирован, идентификатор ApplicationId будет отличаться для каждой операции.

Чтобы пометить отдельные операции открытия с помощью другого ApplicationId, сначала задайте AppInstanceID значение GUID. Затем можно добавить SMB_CCF_APP_INSTANCE_EA_NAME в список расширенных атрибутов при вызове NtCreateFile. Если приложение также передает флаг NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR, AppInstanceID должна быть NETWORK_APP_INSTANCE_EA структура.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	ntifs.h