UpdateNtmsOmidInfo, fonction (ntmsapi.h)

  • Article

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction UpdateNtmsOmidInfo met à jour la base de données RSM avec les informations d’étiquette immédiatement après l’écriture sur le support nouvellement alloué.

Syntaxe

DWORD UpdateNtmsOmidInfo(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       labelType,
  [in] DWORD       numberOfBytes,
  [in] LPVOID      lpBuffer
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpMediaId

Identificateur unique d’un élément de média logique.

[in] labelType

Type d’étiquette. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
NTMS_OMID_TYPE_FILESYSTEM_INFO
 Le paramètre lpBuffer contient une structure NTMS_FILESYSTEM_INFO. Cet indicateur est utilisé pour les médias qui contiennent des systèmes de fichiers.
NTMS_OMID_TYPE_RAW_LABEL
 Le paramètre lpBuffer contient les octets bruts de l’étiquette de l’application. Cet indicateur est utilisé pour les médias qui contiennent des étiquettes écrites par l’application.

[in] numberOfBytes

Nombre d’octets envoyés dans le paramètre lpBuffer .

[in] lpBuffer

Informations d’étiquette. Le format de ce paramètre dépend de la valeur du paramètre labelType .

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 L’accès à un ou plusieurs objets RSM est refusé.
ERROR_DATABASE_FAILURE
 Échec de la requête ou de la mise à jour de la base de données.
ERROR_INVALID_HANDLE
 La valeur spécifiée dans le paramètre hSession n’est pas valide.
ERROR_INVALID_MEDIA
 Impossible de récupérer la définition de média logique à partir de la base de données.
ERROR_INVALID_PARTITION
 Impossible de récupérer la définition latérale de la base de données.
ERROR_INVALID_PARAMETER
 Le paramètre lpMediaId est NULL.
ERROR_NOT_CONNECTED
 Impossible de se connecter au service RSM.
ERROR_SUCCESS
 La fonction a réussi.

Remarques

L’application met à jour RSM avec les informations fournies par la fonction UpdateNtmsOmidInfo et RSM vérifie les informations dans la base de données. Les informations d’étiquette sont stockées dans la base de données RSM avec le côté associé à ce LMID.

La fonction UpdateNtmsOmidInfo doit être exécutée sur le serveur RSM. L’exécution à distance de cette fonction génère une erreur.

Pour le support sur bande, lpBuffer doit pointer vers une mémoire tampon qui contient l’étiquette qui vient d’être écrite sur la bande. Les données de cette mémoire tampon sont transmises directement au point d’entrée ClaimMediaLabel de chaque MLL. L’une des mll installées doit reconnaître une étiquette valide dans ces données.

Pour les médias avec des systèmes de fichiers, lpBuffer doit être un pointeur vers une mémoire tampon qui contient la structure suivante :


typedef struct {
    WCHAR   FileSystemType[64];
    WCHAR   VolumeName[256];
    DWORD   SerialNumber;
} NTMS_FILESYSTEM_INFO;

RSM utilise ces informations de système de fichiers comme OMID. Les utilitaires de format (LDM, explorateur, format.com, etc.) exécutent efficacement les mêmes fonctionnalités que cet appel. Une application qui effectue sa propre mise en forme ou ses propres formats avec un type de système de fichiers tiers doit uniquement appeler UpdateNtmsOmidInfo pour le support du système de fichiers.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntmsapi.h
Bibliothèque Ntmsapi.lib
DLL Ntmsapi.dll

Voir aussi

Fonctions de gestion des identificateurs sur le support