Identificadores HINTERNET
Esta sección contiene información sobre los identificadores que usan las funciones winINet y la jerarquía en la que funcionan.
Acerca de los identificadores HINTERNET
Los identificadores creados y usados por las funciones winINet son de tipo HINTERNET. Las funciones winINet devuelven identificadores HINTERNET que no son intercambiables con otros tipos de identificadores. Por lo tanto, no se pueden usar con funciones como ReadFile o CloseHandle. Del mismo modo, no se pueden usar otros tipos de identificador con las funciones winINet. Por ejemplo, un identificador devuelto por CreateFile no se puede pasar a InternetReadFile.
La función InternetCloseHandle cierra los identificadores de tipo HINTERNET. Tenga en cuenta que los valores de control se reciclan rápidamente; por lo tanto, si se cierra un identificador y se genera inmediatamente un nuevo identificador, existe una buena posibilidad de que el nuevo identificador tenga el mismo valor que el identificador que acaba de cerrar.
Controlar jerarquía
Los identificadores HINTERNET se mantienen en una jerarquía de árboles. El identificador devuelto por la función InternetOpen es el nodo raíz. Los identificadores devueltos por la función InternetConnect ocupan el siguiente nivel. Los identificadores devueltos por las funciones FtpOpenFile, FtpFindFirstFile y HttpOpenRequest son los nodos hoja.
Windows XP y Windows Server 2003 R2 y versiones anteriores: Los identificadores devueltos por , GopherOpenFile y GopherFindFirstFile también son nodos hoja.
En el diagrama siguiente se muestra la jerarquía de los identificadores HINTERNET . Cada cuadro del diagrama representa una función que devuelve un identificador HINTERNET .
En el nivel superior se encuentra la función InternetOpen , que crea el identificador raíz. El siguiente nivel contiene las funciones InternetOpenUrl e InternetConnect . Las funciones que usan el identificador devuelto por InternetConnect constituyen el último nivel.
En el diagrama siguiente se muestran las funciones que dependen del identificador creado por InternetOpenUrl. Los cuadros sombreados representan funciones que devuelven identificadores HINTERNET , mientras que los cuadros sin formato representan funciones que usan el identificador HINTERNET creado por la función asociada.
Las funciones InternetQueryDataAvailable, InternetReadFile e InternetSetFilePointer usan el identificador HINTERNET creado por InternetOpenUrl.
Jerarquía ftp
En el diagrama siguiente se muestran las funciones FTP que dependen del identificador de sesión FTP devuelto por InternetConnect. Los cuadros sombreados representan funciones que devuelven identificadores HINTERNET , mientras que los cuadros sin formato representan funciones que usan el identificador HINTERNET creado por la función en la que dependen.
Las funciones FtpCreateDirectory, FtpDeleteFile, FtpGetCurrentDirectory, FtpGetFile, FtpPutFile, FtpRemoveDirectory, FtpRenameFile y FtpSetCurrentDirectory usan el identificador HINTERNET creado por InternetConnect.
En el diagrama siguiente se muestran las dos funciones FTP que devuelven identificadores y las funciones que dependen de ellas. Los cuadros sombreados representan funciones que devuelven identificadores HINTERNET , mientras que los cuadros sin formato representan funciones que usan el identificador HINTERNET creado por la función en la que dependen.
La función InternetFindNextFile depende del identificador creado por FtpFindFirstFile, mientras que InternetReadFile e InternetWriteFile usan el identificador creado por FtpOpenFile.
Jerarquía HTTP
En el diagrama siguiente se muestran las relaciones de las funciones que se usan para el protocolo HTTP. Los cuadros sombreados representan funciones que devuelven identificadores HINTERNET , mientras que los cuadros sin formato representan funciones que usan el identificador HINTERNET creado por la función en la que dependen.
Las funciones HttpAddRequestHeaders, HttpQueryInfo, HttpSendRequest, HttpSendRequestEx e InternetErrorDlg dependen del identificador creado por HttpOpenRequest.
En el diagrama siguiente se muestran las funciones que usan el identificador HINTERNET creado por HttpOpenRequest después de enviarlo por HttpSendRequest. Los cuadros sombreados representan funciones que devuelven identificadores HINTERNET , mientras que los cuadros sin formato representan funciones que usan el identificador HINTERNET creado por la función en la que dependen.
Una vez que HttpSendRequest ha usado el identificador devuelto por HttpOpenRequest, se puede usar en InternetQueryDataAvailable, InternetReadFile y InternetSetFilePointer.
Después de que HttpSendRequestEx haya usado el identificador devuelto por HttpOpenRequest, httpEndRequest, InternetReadFileEx e InternetWriteFile pueden usar el identificador. Después de llamar a HttpEndRequest , internetReadFile, InternetSetFilePointer e InternetQueryDataAvailable pueden usar el identificador.
Nota:
WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).