CreateNtmsMediaA, fonction (ntmsapi.h)
[Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]
La fonction CreateNtmsMedia crée une fonction PMID et côté (ou côté) pour un nouvel élément multimédia hors connexion. Le média est placé dans le pool de médias spécifié pour lpPhysicalMedia.
Syntaxe
DWORD CreateNtmsMediaA(
[in] HANDLE hSession,
[in] LPNTMS_OBJECTINFORMATIONA lpMedia,
[in] LPNTMS_OBJECTINFORMATIONA lpList,
[in] DWORD dwOptions
);
Paramètres
[in] hSession
Gérez la session retournée par la fonction OpenNtmsSession.
[in] lpMedia
Pointeur vers une structure NTMS_OBJECTINFORMATION qui contient des informations sur le support à créer. Pour obtenir une description des membres applicables, consultez Remarques.
[in] lpList
Pointeur vers une structure NTMS_OBJECTINFORMATION qui spécifie un tableau de côtés associé au support. Pour obtenir une description des membres applicables, consultez Remarques.
[in] dwOptions
Options. Ce paramètre peut être l’une des valeurs suivantes.
Valeur de retour
Cette fonction retourne l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
NTMS_MODIFY_ACCESS à l’ordinateur ou au pool de médias du média est refusé. D’autres erreurs de sécurité sont possibles, mais indiquent une erreur de sous-système de sécurité.
Windows XP : NTMS_CONTROL_ACCESS au pool multimédia ou NTMS_MODIFY_ACCESS à la bibliothèque hors connexion est refusée. D’autres erreurs de sécurité sont possibles, mais indiquent une erreur de sous-système de sécurité. |
|
Base de données inaccessible ou endommagée. |
|
La base de données est complète. |
|
L’option NTMS_ERROR_ON_DUPLICATE a été fournie et un support existe déjà avec cet OMID. |
|
Le handle de session est manquant ou n’est pas valide. |
|
Une entrée existe déjà pour un support avec ce code-barres. |
|
Le pool de supports spécifié n’existe pas ou n’est pas un pool d’applications ou d’importation valide. |
|
Un paramètre est manquant ou la taille des informations sur l’objet ou le type d’objet n’est pas valide. |
|
Le nombre de côtés spécifiés ne correspond pas au nombre de côtés associés au type de média du pool de médias. |
|
Échec d’allocation de mémoire pendant le traitement. |
|
La fonction s’est exécutée avec succès. |
Remarques
Le paramètre
| Membre | Description |
|---|---|
| dwSize | [in] CreateNtmsMedia vérifie que cette taille est égale à la longueur d’une structure NTMS_OBJECTINFORMATION contenant une structure NTMS_PMIDINFORMATION. Elle retourne ERROR_INVALID_PARAMETER si la taille est incorrecte. |
| dwType | [in] CreateNtmsMedia vérifie que la valeur NTMS_PHYSICAL_MEDIA a été fournie. Elle retourne ERROR_INVALID_PARAMETER si le type fourni est incorrect. |
| créé | [out] Indique l’heure à laquelle l’objet multimédia physique a été entré dans la base de données NTMS. |
| modifié | [out] Indique l’heure à laquelle l’objet multimédia physique a été entré dans la base de données NTMS. |
| ObjectGuid | [in/out] Identificateur unique de l’objet multimédia physique (PMID). Si une valeur deNULL non est fournie, la valeur est utilisée comme GUID du support physique, sinon un GUID est généré. |
| activé | [in] Indique si le support physique doit être activé ou non. |
| dwOperationalState | [out] Doit être NTMS_READY. |
| szName | [in/out] CreateNtmsMedia permet à une application de spécifier le nom d’un nouveau support physique. Cela permet à l’application de continuer à utiliser le nom d’un support après le déplacer d’un ordinateur RSM vers un autre. La sélection d’affectation de noms par défaut RSM est la suivante : pour un seul côté : Code-barres, puis Valeur d’informations d’étiquette ou Numéro de séquence ;. pour le code-barres multimédia à plusieurs côtés, puis le numéro de séquence.
Notez que le nom qui apparaît dans l’interface utilisateur RSM d’une partition est ce nom (le nom attribué à l’objet multimédia physique). |
| szDescription | [in] Paramètre facultatif qui peut être défini à l’aide de CreateNtmsMedia. Fournissez la chaîne vide (« \0 ») pour éviter de passer une valeur pour la description. |
Voici une liste de membres et de descriptions pour la structure NTMS_PMIDINFORMATION.
| Membre | Description |
|---|---|
| CurrentLibrary | [in] Doit être la NULL_GUID ou le GUID de la bibliothèque hors connexion. |
| MediaPool | [in] Doit être le GUID d’un pool d’applications ou d’importation valide.
CreateNtmsMedia vérifie qu’il s’agit du GUID d’un pool d’applications ou d’importation valide. Il vérifie également que le nombre de partitions fournies est correct pour le type de média associé à ce pool de supports. |
| emplacement | [out] Doit être la NULL_GUID. |
| LocationType | [out] Doit être NTMS_STORAGESLOT. |
| HomeSlot | [out] Doit être la NULL_GUID. |
| MediaType | [out] CreateNtmsMedia définit le type de média sur le type de média associé au pool de supports fourni. |
| szBarCode | [in/out] Le code-barres est supprimé de tous les espaces de fin. CreateNtmsMedia n’effectue aucune tentative supplémentaire pour vérifier la validité du code-barres. |
| BarCodeState | [out] Le BarCodeState |
| szSequenceNumber | [out] CreateNtmsMedia attribue au média nouvellement créé un numéro de séquence, qui est retourné dans ce membre. |
| MediaState | [out] CreateNtmsMedia définit MediaState sur NTMS_MEDIASTATE_IDLE. |
| dwNumberOfPartitions | [in] Définit le nombre de structures NTMS_OBJECTINFORMATION représentant des côtés pour ce support. CreateNtmsMedia vérifie que le nombre de côtés spécifiés correspond au nombre de côtés implicites par le pool de médias auquel il doit être affecté. S’ils ne correspondent pas, ERROR_MEDIA_INCOMPATIBLE est retourné. |
| dwMediaTypeCode | [in] Code de type de média SCSI.
Ce membre n’est pas utilisé par RSM, mais peut être utilisé par les applications écrites dans RSM pour plus d’informations sur le média. Pour obtenir une description de ce à quoi ce membre doit être défini, consultez la spécification SCSI du fabricant de matériel pour connaître les paramètres possibles. RSM met à jour ce membre lorsqu’il monte le support nouvellement importé pour la première fois. |
| dwDensityCode | [in] Code de densité SCSI.
Ce membre n’est pas utilisé par RSM, mais peut être utilisé par les applications écrites dans RSM pour plus d’informations sur le média. Pour obtenir une description de ce à quoi ce membre doit être défini, consultez la spécification SCSI du fabricant de matériel pour connaître les paramètres possibles. RSM met à jour ce membre lorsqu’il monte le support nouvellement importé pour la première fois |
Le paramètre lpList
| Membre | Description |
|---|---|
| dwSize | [in] CreateNtmsMedia vérifie que la taille fournie correspond à la longueur attendue d’une structure NTMS_OBJECTINFORMATION contenant une structure NTMS_PARTITIONINFORMATION. Elle retourne ERROR_INVALID_PARAMETER si la taille est incorrecte. |
| dwType | [in] CreateNtmsMedia vérifie que la valeur NTMS_PARTITION a été fournie. Elle retourne ERROR_INVALID_PARAMETER si le type fourni est incorrect. |
| créé | [out] Indique l’heure à laquelle l’objet de partition a été entré dans la base de données RSM. |
| modifié | [out] Indique l’heure à laquelle l’objet de partition a été entré dans la base de données RSM. |
| ObjectGuid | [in/out] Identificateur unique du côté. Si une valeur NULL non |
| activé | [in] Détermine si le côté doit être activé ou non. |
| dwOperationalState | [out] Doit être NTMS_READY. |
| szName | [in] Nom d’un nouveau côté. |
| szDescription | [in] Paramètre facultatif qui peut être défini à l’aide de CreateNtmsMedia. Fournissez la chaîne vide (« \0 ») pour éviter de passer une valeur pour la description. |
| PhysicalMedia | [out] GUID de l’objet côté nouvellement créé. |
| logicalMedia | [in/out] Paramètre d’entrée facultatif, ainsi qu’un paramètre de sortie. Si le GUID est fourni, CreateNtmsMedia tente de créer un objet multimédia logique avec le GUID préaffecté. Si le GUID n’est pas unique, CreateNtmsMedia retourne une erreur. |
| d’état | [in] Tout état latéral valide. |
| côté | [out] CreateNtmsMedia définit le nombre latéral sur son décalage dans le tableau Partitions. |
| dwOmidLabelIdLength | [in] Doit être une valeur positive.
CreateNtmsMedia utilise le dwOmidLabelIdLength pour déterminer le nombre d’octets significatifs dans le membre OmidLabelId. Si la valeur n’est pas correcte, l'OmidLabelId enregistré est incorrect. |
| OmidLabelId | [in] Doit être une étiquette multimédia valide qui peut être reconnue par un MLL installé. |
| szOmidLabelType | [in] Ne doit pas être une chaîne vide. |
| szOmidLabelInfo | [in] Peut être la chaîne vide. |
| dwMountCount | [in] Toute valeur est acceptée. |
| dwAllocateCount | [in] Toute valeur est acceptée. |
| capacité | [in] Code de capacité SCSI.
Ce membre n’est pas utilisé par RSM, mais peut être utilisé par les applications écrites dans RSM pour plus d’informations sur le média. Pour obtenir une description de ce à quoi ce membre doit être défini, consultez la spécification SCSI du fabricant de matériel pour connaître les paramètres possibles. RSM met à jour ce membre lorsqu’il monte le support nouvellement importé pour la première fois. |
Note
L’en-tête ntmsapi.h définit CreateNtmsMedia comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | ntmsapi.h |
| bibliothèque | Ntmsapi.lib |
| DLL | Ntmsapi.dll |