IOpcFactory ::CreateStreamOnFile, méthode (msopc.h)

Article
11/20/2024

Crée un flux sur un fichier. Cette méthode est un wrapper simplifié pour un appel à la fonction CreateFile. paramètres CreateFile qui ne sont pas exposés par le biais de cette méthode utilisent leurs valeurs par défaut. Pour plus d’informations, consultez CreateFile.

Syntaxe

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Paramètres

[in] filename

Nom du fichier sur lequel le flux est créé.

[in] ioMode

Valeur qui décrit l’état de lecture/écriture du flux à créer.

[in] securityAttributes

Pour plus d’informations sur la structure SECURITY_ATTRIBUTES dans ce paramètre, consultez la fonction CreateFile.

[in] dwFlagsAndAttributes

Paramètres et attributs du fichier. Pour la plupart des fichiers, FILE_ATTRIBUTE_NORMAL pouvez être utilisé.

Pour plus d’informations sur ce paramètre, consultez CreateFile.

[out, retval] stream

Pointeur vers l’interface IStream du flux.

Valeur de retour

La méthode retourne une HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Retourner le code	Description
S_OK	La méthode a réussi.
E_INVALIDARG	La valeur passée dans le paramètre ioMode n’est pas une valeur d’énumération OPC_STREAM_IO_MODE valide.
E_POINTER	Au moins l’un des paramètres de nom de fichier et de flux est NULL.
erreur de fonction CreateFile	Un code d’erreur HRESULT à partir de la fonction CreateFile.

Remarques

N’utilisez pas de flux pour sérialiser les données de package lorsque le même flux est utilisé pour désérialiser un package, car la tentative peut entraîner un comportement non défini.

Pour plus d’informations sur l’utilisation de cette méthode lors du chargement ou de l’enregistrement d’un package, consultez la Chargement d’un package ou enregistrement d’une tâche de programmation de package.

prise en charge de sur les versions antérieures de Windows

Le comportement et les performances de cette méthode sont identiques sur toutes les versions de Windows prises en charge. Pour plus d’informations, consultez Prise en main de l’API d’empaquetageet Mise à jour de plateforme pour Windows Vista.

Sécurité des threads

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main de l’API d’empaquetage.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	msopc.h