Função ChangeNtmsMediaType (ntmsapi.h)
[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o Windows Server 2008 R2.]
A função ChangeNtmsMediaType move o PMID especificado para o pool de mídia de destino especificado e define o identificador de tipo de mídia do PMID para o tipo de mídia do pool de mídia de destino.
Sintaxe
DWORD ChangeNtmsMediaType(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaId,
[in] LPNTMS_GUID lpPoolId
);
Parâmetros
[in] hSession
Identificador para a sessão retornada pela função OpenNtmsSession .
[in] lpMediaId
Identificador exclusivo da mídia física a ser movida.
[in] lpPoolId
Identificador exclusivo do pool de mídia do qual a mídia deve ser alocada.
Retornar valor
Essa função retorna um dos valores a seguir.
| Valor | Significado |
|---|---|
|
NTMS_MODIFY_ACCESS para o computador ou o pool de mídia da mídia é negado. Outros erros de segurança são possíveis, mas indicam um erro de subsistema de segurança.
Windows XP: NTMS_MODIFY_ACCESS ao pool de mídia da mídia é negada. |
|
O banco de dados está inacessível ou danificado. |
|
O banco de dados está cheio. |
|
O identificador de sessão está ausente ou não é válido. |
|
A ID do pool de mídia não é válida. |
|
O pool de mídia ou a ID de mídia está ausente. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
A função foi bem-sucedida. |
Comentários
A função ChangeNtmsMediaType usa a mesma política para mover mídia que a função MoveToNtmsMediaPool (mídia não reconhecida só pode ser movida para o pool gratuito).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ntmsapi.h |
| Biblioteca | Ntmsapi.lib |
| DLL | Ntmsapi.dll |