Méthode CreateMaskingSet de la classe MSFT_StorageSubSystem

Crée un ensemble de masques.

Un jeu de masquage est un regroupement logique de disques virtuels, de ports cibles et d’initiateurs dans le but d’afficher des disques virtuels pour héberger des ordinateurs

Syntaxe

UInt32 CreateMaskingSet(
  [in]  String              FriendlyName,
  [in]  String              VirtualDiskNames[],
  [in]  UInt16              DeviceAccesses[],
  [in]  String              DeviceNumbers[],
  [in]  String              TargetPortAddresses[],
  [in]  String              InitiatorAddresses[],
  [in]  UInt16              HostType,
  [in]  Boolean             RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              CreatedMaskingSet,
  [out] String              ExtendedStatus
);

Paramètres

FriendlyName [in]

Nom convivial du jeu de masquage.

Les noms conviviaux sont censés être descriptifs, mais ils ne doivent pas nécessairement être uniques.

Ce paramètre est obligatoire et ne peut pas être NULL.

VirtualDiskNames [in]

Liste des disques virtuels à afficher aux initiateurs dans le jeu de masquage. Chaque disque doit être spécifié par l’identificateur stocké dans la propriété Name de son objet MSFT_VirtualDisk

Ce paramètre a un mappage 1 :1 avec le paramètre DeviceAccesses . Les deux tableaux doivent avoir la même longueur et les éléments doivent être organisés dans le même ordre.

DeviceAccesses [in]

Niveau d’accès que l’initiateur doit avoir à chaque disque virtuel spécifié dans le paramètre VirtualDiskNames . Ce paramètre a un mappage 1 :1 avec le paramètre VirtualDiskNames . Les deux tableaux doivent avoir la même longueur et les éléments doivent être organisés dans le même ordre.

Inconnu (0)

Lecture en écriture (2)

Lecture seule (3)

Aucun accès (4)

DeviceNumbers [in]

Spécifie l’ordre dans lequel les disques virtuels doivent être affichés aux initiateurs. Cette fonctionnalité est disponible uniquement si la propriété MaskingClientSelectableDeviceNumbers du sous-système de stockage a la valeur TRUE. S’il est spécifié, ce paramètre doit avoir un mappage 1 :1 avec le paramètre VirtualDiskNames .

TargetPortAddresses [in]

Ports cibles à utiliser lors de l’affichage des disques virtuels aux initiateurs. Le nombre de ports cibles pouvant être spécifiés dépend de la propriété MaskingPortsPerView du sous-système. Si MaskingPortsPerView a la valeur Tous les ports cibles partagent la même vue, ce paramètre est ignoré et tous les ports cibles sur le système sont associés à ce jeu de masquage.

InitiatorAddresses [in]

Initiateurs auxquels les disques virtuels doivent être affichés. Si la propriété MaskingOneInitiatorIdPerView du sous-système a la valeur TRUE, un seul initiateur peut être spécifié pour ce jeu de masquage. La liste des formats d’adresse d’initiateur valides est spécifiée par la propriété MaskingValidInitiatorIdTypes du sous-système.

HostType [in]

Le système d’exploitation hôte ou d’autres facteurs environnementaux hôtes qui peuvent influencer le comportement que le système de stockage doit avoir lors de l’affichage d’un disque virtuel à un initiateur.

Les valeurs comprises entre 22 et 32767 (inclus) sont réservées à DMTF. Les valeurs comprises entre 32768 et 65535 (inclus) sont réservées aux fournisseurs.

Inconnu (0)

Autre (1)

Standard (2)

Solaris (3)

HPUX (4)

OpenVMS (5)

Tru64 (6)

Netware (7)

Sequent (8)

AIX (9)

DGUX (10)

Dynix (11)

Irix (12)

Routeur de stockage Cisco iSCSI (13)

Linux (14)

Microsoft Windows (15)

OS400 (16)

TRESPASS (17)

HI-UX (18)

VMware ESXi (19)

Microsoft Windows Server 2008 (20)

Microsoft Windows Server 2003 (21)

DMTF Reserved (22..32767)

Spécifique au fournisseur (32768..65535)

RunAsJob [in]

Si la valeur est TRUE, cette méthode utilise le paramètre CreatedStorageJob lorsque la maintenance de la requête prend beaucoup de temps. Si un travail de stockage a été créé pour suivre l’opération, cette méthode retourne paramètres de méthode vérifiés - Travail démarré.

Si la valeur est FALSE ou NULL, cette méthode suit le comportement asynchrone WMI par défaut, tel que déterminé par la méthode du client pour l’appel. En d’autres termes, elle est synchrone, sauf demande contraire.

CreatedStorageJob [out]

Si RunAsJob a la valeur TRUE et que cette méthode prend beaucoup de temps à s’exécuter, ce paramètre reçoit une référence à l’objet de travail de stockage utilisé pour suivre l’opération de longue durée.

CreatedMaskingSet [out]

Si le jeu de masquage est créé avec succès, ce paramètre reçoit une chaîne qui contient un objet MSFT_MaskingSet incorporé.

ExtendedStatus [out]

Chaîne qui contient un objet MSFT_StorageExtendedStatus incorporé.

Ce paramètre permet au fournisseur de stockage de retourner des informations d’erreur étendues (spécifiques à l’implémentation).

Valeur retournée

Réussite (0)

Non pris en charge (1)

Erreur non spécifiée (2)

Délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

Paramètres de méthode vérifiés - Travail démarré (4096)

Accès refusé (40001)

Il n’y a pas suffisamment de ressources pour terminer l’opération. (40002)

Impossible de se connecter au fournisseur de stockage. (46000)

Le fournisseur de stockage ne peut pas se connecter au sous-système de stockage. (46001)

Le disque virtuel spécifié est introuvable. (50000)

Le numéro d’appareil spécifié n’est pas valide. (52000)

Le HostType demandé n’est pas pris en charge. (52001)

DeviceAccess doit être spécifié pour chaque disque virtuel. (52002)

L’adresse de l’initiateur spécifiée n’est pas valide (53000)

Une seule adresse d’initiateur est acceptable pour cette opération. (53001)

L’adresse de port cible spécifiée n’est pas valide. (54000)

Configuration requise

Voir aussi

MSFT_StorageSubSystem