--------------------------------------------------------------
Viktig-fil om Microsoft(R) ActiveX(R)-dataobjekter versjon 2.1
--------------------------------------------------------------

(c) 1998 Microsoft Corporation. Med enerett.

Dette dokumentet inneholder ny informasjon eller tilleggsopplysninger som supplerer dokumentasjonen for Microsoft ActiveX(R)-dataobjekter (ADO).

-------
INNHOLD
-------

1. PRODUKTBESKRIVELSE
   
2. NYE FUNKSJONER
2.1 Sking og indeksering
2.2 Oppdatering og synkronisering av rader 
2.3 Microsoft OLE DB Persistence Provider
2.4 Microsoft Data Shaping Service for OLE DB
2.5 Microsoft OLE DB Remoting Provider

3. TEKNISKE MERKNADER
3.1 Sikkerhetsforbedringer
3.2 Restriktiv virkemte
3.3 Tilpasse sikkerhetsinnstillingene

4. KJENTE PROBLEMER, BEGRENSNINGER, LSNINGER OG UTFYLLENDE MERKNADER TIL DOKUMENTASJONEN

----------------------
1. PRODUKTBESKRIVELSE
----------------------

ActiveX-dataobjekter (ADO) er et automatisk basert grensesnitt for datatilgang. ADO bruker OLE DB-grensesnittet til  f tilgang til en rekke forskjellige datakilder, blant annet data fremskaffet via ODBC.

Brukere av RDO og DAO br raskt bli fortrolige med  programmere for ADO, fordi den generelle utformingen av ADO stammer fra vre erfaringer med  utvikle disse grensesnittene.

Microsoft Remote Data Service (RDS) er en komponent i ADO som gir rask og effektiv datatilkobling og et datapubliseringsrammeverk for programmer som ligger under Microsoft Internet Explorer. Den er basert p en distribuert klient/server-teknologi som fungerer via HTTP, HTTPS (HTTP via SSL) og DCOM-programprotokoller. Ved hjelp av dataaktiverte ActiveX-kontroller srger RDS for datatilgangsprogrammering etter Microsoft Visual Basic(R)-mnster for Web-utviklere som har behov for  utvikle distribuerte, dataintensive programmer for bruk p firmaets intranett eller Internett.

-----------------
2. NYE FUNKSJONER
-----------------

ADO 2.1 inneholder flere nye funksjoner for utviklere.

2.1 Sking og indeksering
Metoden Seek og egenskapen Index gir rask, indeksbasert lokalisering av rader i et postsett.

2.2 Oppdatering og synkronisering av rader
Den nye radmodusen gir brukeren tilpasset kontroll over oppdatering og synkronisering av rader for postsett som er opprettet ved hjelp av en JOIN-operasjon. Sju nye dynamiske egenskaper kontrollerer virkemten til de fem eksisterende metodene.

2.3 Microsoft OLE DB Persistence Provider
Sammen med metodene Save og Open i postsettobjektet, lagrer og gjenoppretter Microsoft OLE DB Persistence Provider et postsett til en fil. I denne versjonen kan et postsett lagres i Extensible Markup Language-format (XML), som er standard for  definere brukerdefinerte koder for data som overfres via Internett.

2.4 Microsoft Data Shaping Service for OLE DB
Microsoft Data Shaping Service for OLE DB, som sttter dataforming, kan n:

2.4.1 Omforme et tidligere formet postsett. For  kunne sttte denne funksjonen har postsettene n en Name-egenskap som bestr s lenge forbindelsen varer. 

2.4.2 Utfre mengdeberegninger p en kolonne p et hvilket som helst niv i et formet postsett, ikke bare p umiddelbart underordnede objekter. Denne funksjonen bruker fullt kvalifiserte kapittelnavn til  forme en bane til nsket niv og kolonne.

2.4.3 COMPUTE-kommandoer med parametre kan ha et vilkrlig antall mellomliggende COMPUTE-setningsdeler mellom setningsdelen PARAMETER og parameterens argument. 

2.5 Microsoft OLE DB Remoting Provider
Microsoft OLE DB Remoting Provider blir en standard datatjeneste og fr nye dynamiske egenskaper for kt ytelse, bedre brukerkontroll og bakoverkompatibilitet med ADO 2.0.


---------------------
3. TEKNISKE MERKNADER
---------------------

3.1 Sikkerhetsforbedringer

Denne versjonen inneholder sikkerhetsforbedringer for ADO- og RDS-objekter, slik at noen av operasjonene er begrenset nr Internet Explorer kjres i en "sikker" modus.

3.1.1. Soner
Du kan angi forskjellige sikkerhetsinnstillinger for forskjellige "soner" i Internett Explorer 4.0 for  angi hvordan ADO- og RDS-objekter skal fungere i disse sonene. Flgende fire soner er definert i Internet Explorer 4.0:
*  Internett
*  Lokalt intranett 
*  Begrensede omrder 
*  Klarerte omrder

3.1.2. Sikkerhetsniver
For hver av disse sonene kan du angi hvilket sikkerhetsniv som skal brukes. Flgende sikkerhetsniver er tilgjengelige for hver sone:
*  Hyt 
*  Middels
*  Lavt
*  Egendefinert

Som med alle andre ActiveX-kontroller m sikkerhetsnivet settes til "Middels" eller "Hyt" for at ADO- og RDS-objekter i det hele tatt skal fungere i Internet Explorer 4.0. Egendefinerte innstillinger brukes til  angi hvordan ADO- og RDS-objekter skal fungere i sikker eller usikker modus.

3.2 Restriktiv virkemte

Alle usikre operasjoner p ADO- og RDS-objekter i Internet Explorer 4.0 vil som standard resultere i et sprsml til brukeren ved pning av sider fra en sone p et lokalt intranett, en sone med klarerte omrder og Internett-sonen. Usikre operasjoner p ADO- og RDS-objekter er som standard deaktivert for sider som lastes fra en sone med begrensede omrder. Nedenfor flger en beskrivelse av hvordan ADO og RDS fungerer nr de kjres i disse modiene:

3.2.1 Sikre objekter
Flgende objekter anses som "sikre". Dette betyr at usikre operasjoner (se punkt 3.2.3) ikke er tillatt i et sikkert milj (for eksempel som standard i Internet Explorer, med mindre det brukes egendefinerte innstillinger til  kjre i en usikker modus), og tillatt i et usikkert milj (for eksempel Visual Basic).
a. Objektet RDS.DataControl
b. Objektet RDS.DataSpace
c. Objektet ADO Recordset

3.2.2 Usikre objekter
Flgende objekter anses som "usikre". De kan ikke opprettes direkte eller indirekte (og gis til en bruker) nr det brukes et sikkert milj.
a. Objektet RDSServer.DataFactory
b. Objektet ADO Connection
c. Objektet ADO Command

3.2.3 Usikre operasjoner p sikre objekter 
Flgende operasjoner anses som usikre p de "sikre" objektene - RDS.DataControl, RDS.DataSpace og ADO Recordset. Disse operasjonene er ikke tillatt i et sikkert milj, men tillatt i et usikkert milj.

a. RDS.DataControl
i) Alle 2-lagsscenarier og DCOM-scenarier p objektet RDS.DataControl. Dette betyr at du ikke kan pne databasetilkoblinger p en lokal maskin eller fra servere som du kobler deg til ved hjelp av DCOM-protokollen.
ii) Alle 3-lagsoperasjoner via HTTP er begrenset til serveren som siden er lastet ned fra. Dette betyr at egenskapen Server p RDS.DataControl-objektet m vre lik vertsnavnet (http://server) som siden er lastet ned fra. 

b. RDS.DataSpace
i) Alle 2-lagsscenarier og DCOM-scenarier p objektet RDS.DataSpace. Dette betyr at du ikke kan bruke RDS.DataSpace til  kalle objekter p den lokale maskinen eller via DCOM-protokollen.
ii) Alle 3-lagsscenarier via HTTP er begrenset til serveren som siden er lastet ned fra. Dette betyr at den andre parameteren i CreateObject-metodekallet p objektet DataSpace m peke til den samme serveren som siden er lastet ned fra.

c. ADO Recordset
i) Opprette en tilkobling der tjenesten ikke er MS Remote. Tilkoblingsstrengen m begynne med "Provider=MS Remote". Koden "Remote Server" i tilkoblingsstrengen m ogs vre samme navn som serveren siden er lastet ned fra. Lokale 2-lagstilkoblinger og DCOM-tilkoblinger er ikke tillatt.
ii) Lokale Persistence-operasjoner, for eksempel  lagre et postsett p det lokale filsystemet og pne et postsett fra en fil p en lokal maskin.

3.3 Tilpasse sikkerhetsinnstillingene

Virkemten til ADO og RDS kontrolleres av innstillingen for alternativet "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre". Du kan endre sikkerhetsinnstillingene ved  endre sikkerhetsnivet for en bestemt sone. Standardinnstillingene for alternativet "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre" for intranett-sonen er som flger:
Sikkerhetsniv = Hyt 		Verdi = "Deaktiver"
Sikkerhetsniv = Middels	Verdi = "Deaktiver"
Sikkerhetsniv = Lavt		Verdi = "Spr"

Standardinnstillinger i andre sikkerhetssoner finner du i dokumentasjonen for Internet Explorer.

Ved  endre sikkerhetsnivet kan du endre virkemten til frakoblede ADO Recordset-objekter som kjres i Web-leseren. Hvis du vil deaktivere usikre operasjoner og ikke vil bli spurt hver gang en operasjon blir forskt, m du eksplisitt sette verdien for alternativet ovenfor til "Aktiver". Merk ogs at hvis du forsker  utfre en usikker operasjon (eksempelvis lagre et postsett som en fil p det lokale filsystemet) p et ADO-postsett hentet fra RDS.DataControl, m du sette verdien for alternativet ovenfor til "Aktiver". Innstillingen "Spr" fungerer som "Deaktiver" for slike postsettobjekter (som er hentet fra RDS.Datacontrol).

Du kan overstyre standardinnstillingene ved  direkte manipulere de egendefinerte innstillingene for alternativet ovenfor. Du kan velge  fullstendig deaktivere de usikre operasjonene (se ovenfor), angi at en advarsel skal vises hver gang det blir gjort forsk p en slik operasjon, eller aktivere en slik operasjon uten noen advarsel. Du kan angi forskjellige egendefinerte innstillinger for forskjellige sikkerhetssoner. Flgende trinn m utfres hvis du vil tilpasse sikkerhetsinnstillingene for en bestemt sikkerhetssone:

Obs! Nr du aktiverer "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre" (trinn 5 nedenfor), tillater du at ALLE ActiveX-kontroller, bde sikre og usikre, kan brukes fra Web-sider (noe som kan utsette brukernes maskiner for skadelige kontroller eller skadelig skriptkode). Det anbefales derfor at du bare gjr dette i intranett-soner eller soner med klarerte omrder, og ikke i Internett-sonen.

1. Velg Alternativer for Internett p Vis-menyen i Internet Explorer 4.0 for  vise dialogboksen Alternativer for Internett. Velg kategorien Sikkerhet.
2. Velg sonen du vil tilpasse innstillingene for, fra rullegardinlisten Sone. 
3. Velg Egendefinert for for den valgte sonen. Dette aktiverer knappen Innstillinger i dialogboksen.
4. Velg Innstillinger for  vise dialogboksen Sikkerhetsinnstillinger.
5. Hvis du vil aktivere usikre operasjoner (se punkt 3.2.3) p ADO- og RDS-objekter uten  vise advarsler, velger du "Aktiver" for alternativet "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre" i dialogboksen Sikkerhetsinnstillinger. Velg OK.
6. Hvis du vil at det skal vises en advarsel hver gang det gjres et forsk p en usikker operasjon (se punkt 3.2.3) p ADO- og RDS-objekter, merker du av for "Spr" for alternativet "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre" i dialogboksen Sikkerhetsinnstillinger. Velg OK.
7. Hvis du vil fullstendig deaktivere usikre operasjoner (se punkt 3.2.3) p ADO- og RDS-objekter, velger du "Deaktiver" for alternativet "Initialiser og bruk skript p ActiveX-kontroller som ikke er markert som sikre" i dialogboksen Sikkerhetsinnstillinger. Velg OK. 
8. Hvis det er relevant, gjentar du disse trinnene for  tilpasse sikkerhetsinnstillingene for andre sikkerhetssoner. 
9. Velg OK.

ADO- og RDS-objekter vil n fungere p den mten som er definert. Disse innstillingene pvirker flgende virkemter for ADO- og RDS-objekter (se punkt 3.2.3) i den angitte sikkerhetssonen - pning av lokale, 2-lagstilkoblinger, arbeid via DCOM, tilkobling til en annen server enn den som siden opprinnelig ble lastet ned fra, lagring og pning av et postsett til eller fra filer p en lokal maskin.

Hvis du setter de egendefinerte innstillingene til "Spr", vises en advarsel om at siden prver  f tilgang til en datakilde p et annet domene, ved forsk p usikre operasjoner p ADO- og RDS-objekter.

Brukeren fr sprsml om dette er OK, og kan svare enten "Ja" eller "Nei". Hvis svaret er "Ja", fullfres operasjonen. I motsatt fall mislykkes den. 

-----------------------------------------------------------------------------------------
4. KJENTE PROBLEMER, BEGRENSNINGER, LSNINGER OG UTFYLLENDE MERKNADER TIL DOKUMENTASJONEN
-----------------------------------------------------------------------------------------

4.1 Klientrepresentasjon i RDS stttes forelpig ikke p grunn av manglende sttte i operativsystemet.

4.2 Ved oppretting av virtuelle servere i Internet Information Server 4.0 m flgende to ekstra trinn utfres for  konfigurere serveren til  fungere med RDS:

A) Merk av for "Tillat kjretilgang" nr serveren konfigureres.
B) Flytt filen Msadcs.dll til katalogen vrot\msadc, der "vrot" er hjemmekatalogen til den virtuelle serveren.

4.3 Nr du bruker RDS p en IIS-server, kan antall trder per prosessor bestemmes ved  endre registret p Web-serveren. Antall trder per prosessor kan pvirke ytelsen i en situasjon med stor trafikk eller i en situasjon med lite trafikk, men med store sprringer. Du br prve deg frem for  finne de beste resultatene. Den konkrete verdien som m justeres, er:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ADCThreads

der "ADCThreads" er en brukeropprettet REG_DWORD. Gyldig verdiomrde er fra 1 til 50. Standardverdien er 6. Hvis verdien angitt av registernkkelen er strre enn 50, brukes maksimumsverdien (50). Brukeren skal ikke trenge  opprette denne registerverdien. Den er ikke som standard inkludert i registret.

4.4 ADO installeres som standard med en "sikker" RDS Server DataFactory-konfigurasjon. Sikker modus for RDS Server-komponenter vil si at flgende gjelder:

	1. Det kreves en behandler med DataFactory 
	   (denne kommandoen gis ved innstilling av en registernkkel)

	2. Standardbehandleren Msdfmap.handler er registrert, oppfrt i 
	   listen over sikre behandlere, og er merket som standardbehandler.

	3. Filen Msdfmap.ini er installert i Windows-mappen. Du m konfigurere
           denne filen etter de behovene du har, fr du bruker RDS i
	   3-lagsmodus.

Du kan velge  konfigurere en ubegrenset DataFactory-installasjon. DataFactory kan brukes direkte uten den egendefinerte behandleren. Brukerne kan fremdeles bruke en egendefinert behandler ved  endre tilkoblingsstrengene, men det er ikke ndvendig. 

Vi har lagt ved registerfilen Handsafe.reg, som konfigurerer registeroppfringene for behandleren for en sikker konfigurasjon. Kjr Handsafe.reg hvis du vil kjre i sikker modus.

Vi har ogs lagt ved registerfilen Handunsf.reg, som konfigurerer registeroppfringene for behandleren for ubegrenset konfigurasjon. Kjr Handunsf.reg hvis du vil kjre i ubegrenset modus.

Hvis du vil ha mer informasjon om hvordan du bruker RDS-funksjonen for tilpasningsbehandling, kan du lese den tekniske artikkelen "Using the Customization Handler Feature in RDS 2.0", som finnes p adressen http://www.microsoft.com/data/techmat.htm.

4.5 Metoden Find sker i et postsett i den angitte retningen fra gjeldende radposisjon etter posten som oppfyller de angitte skevilkrene. Hvis ingen radposisjon er angitt fr Find kalles, oppstr det en feil.

4.6 For  kunne bruke hendelsene ADO FetchProgress og FetchComplete sammen med Visual Basic, m du minst ha Visual Basic versjon 6.

4.7 Flgende operasjoner anses som "sikre"  bruke i CALC-uttrykk i dataforming:

Abs, Asc, Atn, CBool, CByte, CCur, CDate, CDbl, Chr, ChrB, ChrW, Chr$, ChrB$, CInt, CLng, Cos, CSng, CStr, Cvar, CVDate, CVErr, Date, Date$, DateAdd, DateDiff, DatePart, DateSerial, DateValue, Day, DDB, Error, Error$, Exp, Fix, Format, Format$, FV, Hex, Hex$, Hour, IIF, InStr, Int, IPmt, IRR, IsDate, IsEmpty, IsError, IsNull, IsNumeric, IsObject, LCase, LCase$, Left, LeftB, Left$, LeftB$, Len, Log, LTrim, LTrim$, Mid, Mid$, Minute, MIRR, Month, Now, NPer, NPV, Oct, Oct$, Pmt, PPmt, PV, QBColor, Rate, RGB, Right, RightB, Right$, RightB$, Rnd, RTrim, RTrim$, Second, Sgn, Sin, SLN, Space, Space$, Sqr, Str, Str$, StrComp, StrConv, String, String$, SYD, Tan, Time,Time$, Timer, TimeSerial, TimeValue, Trim, Trim$, TypeName, UCase, UCase$, Val, VarType , Weekday, Year

4.8 ADO 2.1 sttter ikke vedvarende hierarkiske Recordset-objekter i XML-format. 

4.9 Du kan ikke oppdatere dataene i et skrivebeskyttet postsett ved  lagre dataene som XML og redigere XML-filen. En feil vil oppst nr du prver  pne postsettet p nytt fra XML-filen hvis XML-dataene er endret.

4.10 Nr du bruker adUseClient eller arbeider eksternt med SQL Server 6.5 Service Pack 4, vil bruk av nkkelordet DISTINCT i sprringer bli ignorert for oppdaterbare resultatsett. Dette er et problem som gjelder SQL Server, og vil bli lst i en fremtidig Service Pack.

4.11 DataTypeEnum-verdiene som er angitt i emnet Type Property i ActiveX Data Objects Programmer's Reference, inneholder feil. Flgende Enum-verdier er angitt, men finnes ikke og kan ikke brukes:

adArray, adByRef, adVector

Flgende verdier mangler i listen, men finnes og kan brukes:

adChapter     En kapittelverdi p 4 byte som brukes til  angi rader i et underordnet radsett (DBTYPE_HCHAPTER).

adDBFileTime  En filtidsverdi (DBTYPE_DBFILETIME).

adFileTime    En 64-biters verdi som representerer antall intervaller p 100 nanosekunder siden 1. januar 1601 (DBTYPE_FILETIME).

adPropVariant En PROPVARIANT for automatisering (DBTYPE_PROP_VARIANT).

adVarNumeric  En numerisk verdi (bare for objektet Parameter).

4.12 Listen over gyldige verdier for parameteren Options i metoden Execute for Connection- og Command-objekter inneholder feil. Flgende ExecuteOptionEnum-verdi er feilaktig oppfrt to ganger. Den skal bare oppfres n gang, slik:

adCmdTable    Angir at ADO skal vurdere CommandText som et tabellnavn og generere en SQL-sprring for  returnere alle radene fra tabellen som er angitt i CommandText.

Flgende CommandTypeEnum-verdien mangler i listen, men finnes og kan brukes:

adCmdFile     Angir at tjenesten skal vurdere CommandText som et filnavn.

Flgende ExecuteOptionEnum-verdier mangler i listen, men finnes og kan brukes:

adAsyncFetchNonBlocking   Angir at hovedtrden aldri blokkeres under henting. Hvis den forespurte raden ikke er hentet, flyttes gjeldende rad automatisk til slutten av filen.

adExecuteNoRecords        Angir at CommandText er en kommando eller en lagret prosedyre som ikke returnerer rader (for eksempel en kommando som bare setter inn data). Hvis det hentes rader, blir de forkastet og returneres ikke. Alltid kombinert med adCmdText eller adCmdStoredProc. 

4.13 Listen over QueryType Enum-verdier for metoden OpenSchema i et Connection-objekt inneholder feil. Flgende verdier mangler i listen, men finnes og kan brukes:

Enum			Begrensningskolonner

adSchemaDBInfoKeywords	ingen

adSchemaDBInfoLiterals	ingen

adSchemaCubes		CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME

adSchemaDimensions	CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			DIMENSION_NAME
			DIMENSION_UNIQUE_NAME

adSchemaHierarchies	CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			DIMENSION_UNIQUE_NAME
			HIERARCHY_NAME
			HIERARCHY_UNIQUE_NAME

adSchemaLevels		CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			DIMENSION_UNIQUE_NAME
			HIERARCHY_UNIQUE_NAME
			LEVEL_NAME
			LEVEL_UNIQUE_NAME

adSchemaMeasures	CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			MEASURE_NAME
			MEASURE_UNIQUE_NAME

adSchemaProperties	CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			DIMENSION_UNIQUE_NAME
			HIERARCHY_UNIQUE_NAME
			LEVEL_UNIQUE_NAME
			MEMBER_UNIQUE_NAME
			PROPERTY_TYPE
			PROPERTY_NAME

adSchemaMembers		CATALOG_NAME
			SCHEMA_NAME
			CUBE_NAME
			DIMENSION_UNIQUE_NAME
			HIERARCHY_UNIQUE_NAME
			LEVEL_UNIQUE_NAME
			LEVEL_NUMBER
			MEMBER_NAME
			MEMBER_UNIQUE_NAME
			MEMBER_CAPTION
			MEMBER_TYPE
			Treoperatoren (se nedenfor)

De siste sju Enum-verdiene (fra adSchemaCubes til adSchemaMembers) br brukes med multidimensjonale datatjenester. Hvis du vil ha mer informasjon, inkludert definisjonen av begrensningen for treoperatoren i adSchemaMembers, kan du lese programmeringsreferansen for OLE DB for OLAP.

4.14 AffectEnum-verdiene som er angitt i emnet om metoden CancelBatch i ActiveX Data Objects Programmer's Reference, inneholder en feil. Flgende verdi mangler i listen, men finnes og kan brukes:

adAffectAllChapters     Avbryt forestende endringer for alle kapitler. 

4.15 adModeShareDenyNone ConnectModeEnum-verdien er feilaktig beskrevet i emnet om egenskapen Mode. Den skal angis opp som flger:

adModeShareDenyNone	Lar andre pne en tilkobling men alle tillatelser. Verken lese- eller skrivetilgang kan nektes for andre.

4.16
Egenskapen Index returnerte tidligere en feil hvis det ikke var angitt noen indeksering i postsettobjektet.
Nr det gjelder ADO 2.1 i MDAC 2.1 Service Pack 1, returnerer den en tom streng, og lykkes.
