IFtpProviderConstruct-Schnittstelle

Stellt eine Schnittstelle zum Übergeben von Konfigurationseinstellungen an einen Anbieter bereit.

Syntax

interface IFtpProviderConstruct : IUknown 

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der IFtpRoleProvider Schnittstelle verfügbar gemacht werden.

Bemerkungen

Sie können Parameter für einen FTP-Anbieter in der IIS-ApplicationHost.config-Datei angeben, indem Sie eine <activation> Auflistung hinzufügen, die eine Reihe von <providerData> Elementen enthalten kann, die zusätzliche Einstellungen für benutzerdefinierte FTP-Anbieter auflisten. Jedes <providerData> Element ist mit einem Eintrag in der <providerDefinitions> Auflistung gekoppelt und enthält eine Reihe von Schlüssel-Wert-Paaren, die Informationen enthalten, die für jeden Anbieter spezifisch sind.

Der folgende Konfigurationsauszug veranschaulicht einen benutzerdefinierten FTP-Anbietereintrag in der ApplicationHost.config datei und die zugehörigen Informationen.

<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> 

Beispiel

Das folgende Codebeispiel durchläuft das Array der Konfigurationseinstellungen und sendet die Schlüssel-Wert-Paare an den Debugstream.

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; 
   } 

Anforderungen