Metodo IFileSystemImage::CreateFileItem (imapi2fs.h)

Creare un elemento di file con il nome specificato.

Sintassi

HRESULT CreateFileItem(
  [in]  BSTR         name,
  [out] IFsiFileItem **newItem
);

Parametri

[in] name

Stringa contenente il nome dell'elemento file da creare.

[out] newItem

Interfaccia IFsiFileItem del nuovo elemento di file. Al termine, chiamare il metodo IFsiFileItem::Release per rilasciare l'interfaccia.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003
IMAPI_E_INVALID_PARAM	Il nome specificato non è valido. Valore: 0xC0AAB101
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E

Commenti

Dopo aver impostato le proprietà nell'interfaccia IFsiFileItem , chiamare il metodo IFsiDirectoryItem::Add nell'elemento directory padre per aggiungerlo all'immagine del file system.

Requisiti

Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IFileSystemImage

IFsiFileItem