Metodo IFtpProviderConstruct::Cost

Recupera una matrice di coppie chiave/valore dalle impostazioni di configurazione di un provider FTP nel file di ApplicationHost.config IIS.

Sintassi

HRESULT Construct( 
   SAFEARRAY * configurationEntries 
) 

Parametri

Termine Definizione
configurationEntries [IN] Puntatore a un'operatore SAFEARRAY che contiene coppie chiave/valore dalle impostazioni di configurazione IIS.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Valore Descrizione
S_OK Indica che l'operazione ha avuto esito positivo.

Commenti

È possibile specificare i parametri per un provider FTP nel file di ApplicationHost.config IIS aggiungendo una <activation> raccolta, che può contenere una serie di <providerData> elementi che elencano impostazioni aggiuntive per i provider FTP personalizzati. Ogni <providerData> elemento viene associato a una voce nell'insieme <providerDefinitions> e contiene una serie di coppie chiave/valore che contengono informazioni specifiche per ogni provider.

L'estratto della configurazione seguente illustra una voce del provider FTP personalizzata nel file ApplicationHost.config e le relative informazioni correlate.

<system.ftpServer> 
   <providerDefinitions> 
      <add name="FtpDemo" 
         clsid="FtpDemo.DemoProvider" /> 
      <activation> 
         <providerData name="FtpDemo"> 
            <add key="one" value="1" /> 
            <add key="two" value="2" /> 
         </providerData> 
      </activation> 
   </providerDefinitions> 
</system.ftpServer> 

Esempio

L'esempio di codice seguente esegue l'iterazione tramite la matrice di impostazioni di configurazione e invia le coppie chiave/valore al flusso di debug.

public: 
   STDMETHOD(Construct)(SAFEARRAY * configurationEntries) 
   { 
      CONFIGURATION_ENTRY * pArray; 
      HRESULT hr = S_OK; 
      LONG lLbound = 0; 
      LONG lUbound = 0; 
 
      OutputDebugString(L"IFtpProviderConstruct::Construct\n"); 
 
      // Retrieve the upper and lower bounds for the configuration array. 
      SafeArrayGetLBound( configurationEntries, 1, &lLbound ); 
      SafeArrayGetUBound( configurationEntries, 1, &lUbound ); 
 
      // Retrieve a pointer to the array of configuration settings. 
      hr = SafeArrayAccessData(configurationEntries, (void**)&pArray); 
      // Return an error if a failure occurs. 
      if (FAILED(hr)) 
      { 
         return hr; 
      } 
 
      // Loop through the array of configuration setttings and 
      // output the key/value pairs to the debug channel. 
      for(LONG Index = lLbound; Index <= lUbound; Index ++) 
      { 
         OutputDebugString(pArray[Index].bstrKey); 
         OutputDebugString(pArray[Index].bstrValue); 
      } 
 
      // Release the pointer to the array of configuration settings. 
      hr = SafeArrayUnaccessData(configurationEntries); 
      // Return an error if a failure occurs. 
      if (FAILED(hr)) 
      { 
         return hr; 
      } 
 
      return S_OK; 
   } 

Requisiti

Tipo Descrizione
Client - IIS 7.5 in Windows 7
- IIS 8.0 in Windows 8
- IIS 10.0 in Windows 10
Server - IIS 7.5 in Windows Server 2008 R2
- IIS 8.0 in Windows Server 2012
- IIS 8.5 in Windows Server 2012 R2
- IIS 10.0 in Windows Server 2016
Prodotto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Riferimento ftpext.tlb

Vedere anche

Interfaccia IFtpProviderConstruct